邮政国内标快 快递单号查询 快递鸟API接口

调用快递鸟提供的快递查询API标准接口，快速对接100多家快递公司的物流轨迹查询，本篇文章实现<邮政国内标快>的快递单号查询。

首先我们准备好需要用到的资源，

测试商户ID：

test1617571

测试API key：

554343b2-7252-439b-b4eb-1af42c8f2175(此Key仅限测试环境使用)

API测试地址：

http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.json

接下来，我们讲解一下请求参数

一、接口描述/说明

请求系统级参数说明：

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	快递公司编码，邮政国内标快：YZBK	必填
LogisticCode	String	物流单号	必填
CustomerName	String	寄件人或收件人的手机号后四位数字	必填

**

5.返回参数（Return）

**

参数名称	类型	说明	必须要求
EBusinessID	String	用户ID	必填
OrderCode	String	订单编号	必填
ShipperCode	String	快递公司编码	必填
LogisticCode	String	物流运单号	选填
Success	String	成功与否	必填
Reason	String	失败原因	选填
State	String	物流状态：2-在途中,3-签收,4-问题件	必填
Traces
AcceptTime	String	时间	必填
AcceptStation	String	描述	选填
Remark	String	备注	必填

**
我们用邮政国内标快的真实单号（1187763739690）来完成快递单号查询接口的调用，

请求的完整报文（URL编码以后）：

RequestData=+%7b%27OrderCode%27%3a%27%27%2c%27ShipperCode%27%3a%27YZBK%2
7%2c%27LogisticCode%27%3a%271187763739690%27%7d&EBusinessID=1264783&Requ
estType=1002&DataSign=YjFkNzY2ZTNhNjY3NTM0ODZhZmM4ZTRjYjczNDVlNGQ%3d&Dat
aType=2

URL解码的请求报文：

RequestData= {'OrderCode':'','ShipperCode':'YZBK','LogisticCode':'1187763739690'}&EBu
sinessID=1264783&RequestType=1002&DataSign=YjFkNzY2ZTNhNjY3NTM0ODZhZmM4Z
TRjYjczNDVlNGQ=&DataType=2

返回报文信息

-{ “LogisticCode” : “1187763739690”, “ShipperCode” : “YZBK”, “Traces” : [ { “AcceptStation” : “[南昌市]【南昌市向塘揽投部】已收件,揽投员:赵文萍,电话:15070872285”, “AcceptTime” : “2020-03-02 14:16:12” }, { “AcceptStation” : “[南昌市]离开【南昌市向塘揽投部】,下一站【南昌邮件处理中心】”, “AcceptTime” : “2020-03-02 16:21:43” }, { “AcceptStation” : “[南昌市]离开【南昌邮件处理中心】,下一站【武汉邮件处理中心】”, “AcceptTime” : “2020-03-03 07:52:46” }, { “AcceptStation” : “[武汉市]到达【武汉邮件处理中心】（经转）”, “AcceptTime” : “2020-03-03 15:42:12” }, { “AcceptStation” : “[武汉市]离开【武汉邮件处理中心】,下一站【黄冈包件处理班】（经转）”, “AcceptTime” : “2020-03-04 04:55:54” }, { “AcceptStation” : “[黄冈市]到达【黄冈包件处理班】”, “AcceptTime” : “2020-03-04 09:21:08” }, { “AcceptStation” : “[黄冈市]离开【黄冈包件处理班】,下一站【湖北黄梅县处理中心】”, “AcceptTime” : “2020-03-05 09:23:40” }, { “AcceptStation” : “[黄冈市]【湖北黄梅县处理中心】安排投递,投递员:郝金娇,电话:19871949550,揽投部电话:15071681008”, “AcceptTime” : “2020-03-05 13:55:42” } ], “State” : “2”, “EBusinessID” : “1264783”, “Success” : true }

附上详细的接口文档给大家：

http://www.kdniao.com/documents

提供源码下载：

https://download.csdn.net/download/yanghanwen/12139326

调用第三方物流接口，替换自己的key就能直接使用，主要实现了物流在线轨迹查询，订单订阅，轨迹推送，支持上百家家的快递查询接口，包括主流的四通一达，支持上门取件服务，其他接口调用，修改调用指令和参数就能实现。

源码运行演示截图：