快宝物流跟踪

最新推荐文章于 2025-04-29 02:58:17 发布

lizheng500

最新推荐文章于 2025-04-29 02:58:17 发布

阅读量625

点赞数

文章标签： html5

本文链接：https://blog.csdn.net/lizheng500/article/details/123630677

版权

本文档详细介绍了快宝开放平台的物流跟踪API，包括API名称`express.info.get`，适用于电商平台的物流订单跟踪。提供了请求地址、参数示例及响应格式，帮助开发者实现物流信息的查询和处理。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

快宝开放平台

首页
解决方案
产品
API文档
关于我们

开发者指南

13122911354

控制台

API文档

地址库服务
物流跟踪
- 物流查询
- 物流订阅
云打印
电子面单
微掌柜
短信服务
散客下单
基础服务

API文档/物流跟踪/物流查询

应用场景

1.在电商平台购物后，通过购物订单跟踪物流时，调用此API获取物流信息详情

2.处理运费对账时，一键获取运单物流状态

3.批量跟踪及获取运单物流信息

支持品牌列表下载并查看详情

技术咨询请加微信：kuaibao135

接口名称

express.info.get

公共参数

请求地址

环境名称	HTTPS请求地址
正式地址	https://kop.kuaidihelp.com/api

公共请求参数

名称	类型	是否必须	描述
method	string	是	API接口名称
app_id	string	是	用户ID（注册开放平台时分配，在控制台中查看）
sign	string	是	按照规则(md5(app_id + method + ts + api_key))生成的合法性验证签名(32位字符串，字母小写)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密后5030cae3388ecdc2e686379753a0564c
ts	string	是	当前请求的时间戳(10位或13位)
data	string	是	JSON格式请求参数

公共响应参数

名称	类型	是否必须	描述
code	int	是	响应状态码。0-成功，非0-失败下载并查看详情
msg	string	是	返回结果说明
uid	string	是	本次请求唯一业务流水号
data	string	是	JSON格式响应数据

请求参数

名称	类型	是否必须	描述
waybill_codes	string	是	运单号，多个单号之间用","隔开（英文逗号）,最多支持10条
cp_code	string	否	运单号所属快递品牌，需传简称；支持品牌的简称请查看品牌列表下载并查看详情,不传输品牌字段时接口会自动识别品牌后返回结果
result_sort	string	是	返回的物流信息排序（根据物流时间，0-降序排列，1-升序排列，默认值0）
phone	string	否	查顺丰快递时，必填。收发件人，手机号码，后4位（如电话号码13900001234，填写1234即可）

响应参数

名称	类型	是否必须	描述
waybill_code	string	是	运单号
cp_code	string	是	快递公司品牌；支持品牌列表下载并查看详情
status	string	是	物流状态（collected-已揽收；sending-运输中；delivering-派件中；allorgraph-已代收；signed-已签收；question-问题件;)
data	array	是	详细物流信息
order	string	是	物流轨迹顺序，desc 代表降序排列， asc 代表升序排列

请求示例

Java

Python

PHP

Node.js

Curl

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;

import java.util.Map;
import java.util.HashMap;

import java.util.Date;

public class Request {

public static void main(String[] args) {
String host = "http://kop.kuaidihelp.com";
String path = "/api";
String requestMethod = "POST";
Map<String, String> headers = new HashMap<String, String>();
//根据API的要求，定义相对应的Content-Type
headers.put("Content-Type", "application/x-www-form-urlencoded; charset=UTF-8");
Map<String, String> querys = new HashMap<String, String>();
Map<String, String> bodys = new HashMap<String, String>();

String appId = "50001";
String method = "express.info.get";
// 当前时间戳
String ts = new Date().getTime() + "";
String appKey = "bdf3b5f50865ac813cbdfd6c9b572b79";

// 计算签名
String signStr = appId + method + ts + appKey;
String sign = Request.getMD5(signStr, 32);

bodys.put("app_id", appId);
bodys.put("method", method);
bodys.put("ts", ts);
bodys.put("sign", sign);
// data参数是个json格式的字符串  建议使用函数或方法去生成
bodys.put("data", "{ "waybill_codes":"物流单号多个的以英文逗号分隔", "cp_code":"品牌简称","result_sort":"0"}");


try {
	/**
	* 重要提示如下:
	* HttpUtils请从
	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/src/main/java/com/aliyun/api/gateway/demo/util/HttpUtils.java
	* 下载
	*
	* 相应的依赖请参照
	* https://github.com/aliyun/api-gateway-demo-sign-java/blob/master/pom.xml
	*/
	HttpResponse response = HttpUtils.doPost(host, path, requestMethod, headers, querys, bodys);
	System.out.println(response.toString());
	
		//获取response的body
		System.out.println(EntityUtils.toString(response.getEntity()));
	} catch (Exception e) {
		e.printStackTrace();
	}
}

	// 计算md5
    public static String getMD5(String plainText, int length) {
        try {
            MessageDigest md = MessageDigest.getInstance("MD5");//获取MD5实例
            md.update(plainText.getBytes());//此处传入要加密的byte类型值
            byte[] digest = md.digest();//此处得到的是md5加密后的byte类型值

            /*
               下边的运算就是自己添加的一些二次小加密，记住这个千万不能弄错乱，
                   否则在解密的时候，你会发现值不对的（举例：在注册的时候加密方式是一种，
                在我们登录的时候是不是还需要加密它的密码然后和数据库的进行比对，但是
            最后我们发现，明明密码对啊，就是打不到预期效果，这时候你就要想一下，你是否
             有改动前后的加密方式）   
            */
            int i;
            StringBuilder sb = new StringBuilder();
            for (int offset = 0; offset < digest.length; offset++) {
                i = digest[offset];
                if (i < 0)
                    i += 256;
                if (i < 16)
                    sb.append(0);
                sb.append(Integer.toHexString(i));//通过Integer.toHexString方法把值变为16进制
            }
            return sb.toString().substring(0, length);//从下标0开始，length目的是截取多少长度的值
        } catch (NoSuchAlgorithmException e) {
            e.printStackTrace();
            return null;
        }
    }
}