快宝开放平台物流查询api接口
API文档/物流跟踪/物流查询应用场景
1.在电商平台购物后,通过购物订单跟踪物流时,调用此API获取物流信息详情2.处理运费对账时,一键获取运单物流状态3.批量跟踪及获取运单物流信息支持品牌列表下载并查看详情技术咨询请加微信:kuaibao135
接口名称
express.info.get
公共参数
请求地址
环境名称HTTPS请求地址
正式地址https://kop.kuaidihelp.com/api
公共请求参数
名称类型是否必须描述
methodstring是API接口名称
app_idstring是用户ID(注册开放平台时分配,在控制台中查看)
signstring是按照规则(md5(app_id + method + ts + api_key))生成的合法性验证签名(32位字符串,字母小写)如:10000cloud.print.do1524209949bdf3b5f50865ac813cbdfd6c9b572b79加密后5030cae3388ecdc2e686379753a0564c
tsstring是当前请求的时间戳(10位或13位)
datastring是JSON格式请求参数
公共响应参数
名称类型是否必须描述
codeint是响应状态码。0-成功,非0-失败下载并查看详情
msgstring是返回结果说明
uidstring是本次请求唯一业务流水号
datastring是JSON格式响应数据
请求参数
名称类型是否必须描述
waybill_codesstring是运单号,多个单号之间用","隔开(英文逗号),最多支持10条
cp_codestring否运单号所属快递品牌,需传简称;支持品牌的简称请查看品牌列表下载并查看详情,不传输品牌字段时接口会自动识别品牌后返回结果
result_sortstring是返回的物流信息排序(根据物流时间,0-降序排列,1-升序排列,默认值0)
phonestring否查顺丰快递时,必填。收发件人,手机号码,后4位(如电话号码13900001234,填写1234即可)
响应参数
名称类型是否必须描述
waybill_codestring是运单号
cp_codestring是快递公司品牌;支持品牌列表下载并查看详情
statusstring是物流状态(collected-已揽收;sending-运输中;delivering-派件中;allorgraph-已代收;signed-已签收;question-问题件;)
dataarray是详细物流信息
orderstring是物流轨迹顺序,desc 代表降序排列, asc 代表升序排列
请求示例
Java
C#
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-Typeheaders.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; 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; } }}
响应示例
成功响应示例
JSON示例
{
"code":int0
"msg":string"查询成功"
"data":[
0:{
"waybill_code":string"3339809700595"
"cp_code":string"sto"
"status":string"signed"
"data":[
0:{
"time":string"2017-10-03 19:11:00"
"context":string"已签收,签收人是代签"
}
1:{
"time":string"2017-10-03 08:14:33"
"context":string"快件已到达 浙江浦江公司"
}
2:{
"time":string"2017-10-03 01:09:41"
"context":string"由浙江义乌中转部 发往 浙江浦江公司"
}
]
"order":string"desc"
}
]
}
异常响应示例
JSON示例
{
"code":string"错误代码"
"msg":string"错误信息"
"data":{}
}
错误代码
错误码描述
201101查询暂无记录
201102请求参数错误
201103不支持的快递品牌
页:
[1]