看完快递鸟api对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成中通快递接口对接.更适合刚入门的菜鸟,调用快递鸟的中通快递查询API接口,能查询到中通快递单号从收件、运输,到转运中心,派送到签收等各个环节的物流发货状态。快递鸟api接口不区分开发语言,支持Java,C#,PHP,Python,ObjectC等开发语言的程序调用。下面具体讲解实现过程.
目录
1.完成前期准备工作
1.1,去快递鸟官网免费注册一个账号
1.2,免费获得一个apiKey(接口权限验证需要), 获取用户ID和ApiKey
1.3,完成实名认证流程,去认证
1.4,订购一个免费套餐,去订购
2.API接口
2.1,测试调用地址::8080/kdniaosandbox/gateway/exterfaceInvoke.json
2.2,正式调用地址:
2.3,请求方式:POST
2.4,编码格式(utf-8):application/x-www-form-urlencoded;charset=utf-8
2.5,返回类型:JSON
2.6,调试页面:
2.7,调试工具:去调试(使用快递鸟账号登录)
3.请求参数(Headers)
参数名称
类型
说明
必须要求
RequestData
String
请求内容需进行URL(utf-8)编码,请求内容JSON格式,须和DataType一致
必填
EBusinessID
String
用户ID,查看用户ID和ApiKey
必填
RequestType
String
请求指令类型:1002
必填
DataSign
String
签名数据,(Body+ApiKey)进行MD5加密,再进行Base64编码,最后进行URL(utf-8)编码
必填
DataType
String
求、返回数据类型:2-json ,默认Json
选填
4.请求参数(Body)
参数名称
类型
说明
必须要求
OrderCode
String
订单编号
选填
ShipperCode
String
快递公司编码,中通:ZTO
必填
LogisticCode
String
物流运单号
必填
5.返回参数(Return)
参数名称
类型
说明
必须要求
EBusinessID
String
用户ID
必填
ShipperCode
String
快递公司编码
必填
LogisticCode
String
物流运单号
选填
Success
String
成功与否
必填
Reason
String
失败原因
选填
State
String
物流状态:2-在途中,3-签收,4-问题件
必填
Traces
String
时间
AcceptTime
String
必填
AcceptStation
String
描述
选填
Remark
String
备注
必填
6.请求完整报文(示例)
RequestData=%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27ZTO%27%2c%27LogisticCode%27%3a%2778120038107849%27%7d&EBusinessID=1617571&
RequestType=1002&DataSign=YzBmYTViYmExZmFhOGY1ZTY3MWY5OGFjYWRhNWVjNjU%3d&DataType=2
7.成功返回报文(示例)
{
"LogisticCode": "78120038107849",
"ShipperCode": "ZTO",
"Traces": [{
"AcceptStation": "【济源市】 【济源】(0391-6965909) 的 张霞(18839032214) 已揽收",
"AcceptTime": "2020-01-16 18:30:33"
}, {
"AcceptStation": "【济源市】 快件离开 【济源】 已发往 【深圳中心】",
"AcceptTime": "2020-01-16 18:36:41"
}, {
"AcceptStation": "【新乡市】 快件已经到达 【新乡中转】",
"AcceptTime": "2020-01-16 22:45:49"
}, {
"AcceptStation": "【新乡市】 快件离开 【新乡中转】 已发往 【深圳中心】",
"AcceptTime": "2020-01-16 22:47:48"
}, {
"AcceptStation": "【深圳市】 快件已经到达 【深圳中心】",
"AcceptTime": "2020-01-18 04:05:46"
}, {
"AcceptStation": "【深圳市】 快件离开 【深圳中心】 已发往 【深圳龙华】",
"AcceptTime": "2020-01-18 08:34:46"
}, {
"AcceptStation": "【深圳市】 快件已经到达 【深圳龙华】",
"AcceptTime": "2020-01-18 13:14:10"
}, {
"AcceptStation": "【深圳市】 【深圳龙华】 的陈智龙-王颖(13923773902) 正在第1次派件, 请保持电话畅通,并耐心等待(95720为中通快递员外呼专属号码,请放心接听)",
"AcceptTime": "2020-01-18 16:38:35"
}, {
"AcceptStation": "【深圳市】 快件已由【丰巢的鑫茂花园A区(丰巢智能快递柜)】代签收, 如有问题请电联(13923773902 / 4000633333,18025858922), 感谢您使用中通快递, 期待再次为您服务!",
"AcceptTime": "2020-01-18 17:32:15"
}],
"State": "3",
"EBusinessID": "1617571",
"Success": true
}
8.失败返回报文(示例)
文章标题: 中通快递-单号查询接口-物流路由跟踪信息快递鸟api对接教程
文章地址: http://www.danhaowy.com/dfwl/94946.html