即时查询API(接口指令1002)是快递鸟提供的实时查询物流轨迹的服务,用户提供运单号和快递公司,即可查询当前时刻的最新物流轨迹。
该查询接口只能输入快递鸟规定的快递公司编码,格式不对或则编码错误都会返失败的信息,具体编码可下载:2018快递鸟接口支持快递公司编码.xlsx。
接口请求方法是utf-8的编码格式,HTTP POST的接收方式,按照时间升序返回物流跟踪信息。该接口只支持json格式数据,不支持批量查询单号,且并发不超过10次/S。
1、系统级参数:
名称 | 类型(字符长度) | 是否必须 | 描述 |
---|---|---|---|
RequestData | String | R | 请求内容为JSON格式 |
EBusinessID | String | R | 用户ID |
RequestType | String | R | 请求接口指令:1002 |
DataSign | String | R | 数据内容签名:(RequestData(未编码)+ApiKey)进行MD5加密,然后Base64编码,最后进行URL(utf-8)编码 |
DataType | String | R | DataType=2,请求、返回数据类型均为JSON格式 |
2、应用级参数(RequestData)
名称 | 类型(字符长度) | 是否必须 | 描述 |
---|---|---|---|
OrderCode | String(30) | O | 订单编号 |
ShipperCode | String(10) | R | 快递公司编码,参照:2018快递鸟接口支持快递公司编码.xlsx |
LogisticCode | String(30) | R | 请求接口指令:1002 |
官网有提供java、.NET和PHP的demo,下载地址:http://www.kdniao.com/documents-demo
.NET版本demo使用示例:
1、可以按照自己需求新建一个页面,进行传参和展示数据。
2、调用demo中的方法返回结果,对返回结果进行显示处理。
3、将demo中如图所示替换
4、对下图方法中的入参进行处理,result即为返回值。
5、下图即为按照上述方法处理后的效果图。