postStr); // 获取到的post数据就是快递鸟返回的完整报文

时间:2022-04-10 17:17:24

看完快递鸟api极兔快递对接教程这篇文章,然后把源码复制到你的项目上,就能快速完成极兔快递接口对接.更适合刚入门的菜鸟,挪用快递鸟的极兔快递盘问API接口,能盘问到极兔快递单号从收件、运输,,到转运中心,派送到签收等各个环节的物流发货状态。快递鸟api接口不区分隔发语言,撑持Java,C#,PHP,Python,ObjectC等开发语言的措施挪用。下面具体讲解实现过程.

目录 1.完成前期筹备事情

1.1,去快递鸟官网免费注册一个账号

1.2,免费获得一个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   快递公司编码,极兔速递:JTSD   必填  
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%27JTSD%27%2c%27LogisticCode%27%3a%27jt0000052600488%27%7d&
EBusinessID=1264783&RequestType=1002&DataSign=MTYyMDU4NWQ2NmU1ZDI2MDEzNGE5YmVlM2YxYzEzMTM%3d&DataType=2

  7.告成返回报文(示例)

{
"LogisticCode": "JT0000052600488",
"ShipperCode": "JTSD",
"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.掉败返回报文(示例)