免费物流查询API接口对接流程-快递鸟

目前快递鸟物流查询API接口有两种对接方式，这两种方式都需要先到快递鸟官网上填写申请信息（注册网址：/reg）

填写申请信息，信息表格中“日查询次数”要选择对，如果不确认，可以先接入查询接口。

申请完成，登录就可以看到自己的ID和KEY，这个ID和KEY只能一个公司使用，保证数据的稳定性，所以这个ID和KEY都是保密的。

从这一步开始，每日查询次数≤3000次和>3000的对接方式就不一样了。

1.每日查询次数≤3000次（即时查询接口）

即时查询接口，是根据快递单号和快递公司编码实时查询物流轨迹信息的接口。

注册后可以参照如下进行开发对接：

1.1即时查询接口对接描述/说明

（1）根据订单编号和快递公司编码查询物流轨迹信息(支持在快递鸟订单)。

（2）根据快递单号和快递公司编码查询物流轨迹信息。

（3）接口需要指定快递单号的快递公司编码，格式不对或则编码错误都会返失败的信息。

如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码

（4）返回的物流跟踪信息按照发生的时间升序排列。

（5）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（6）请求系统级参数说明：

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。

（7）接口地址：API地址：/Ebusiness/EbusinessOrderHandle.aspx （8）接口参数

请求内容字段定义

返回参数定义

2.每日查询次数>3000（订阅接口）

订阅推送接口，用户订阅快递单号，快递鸟系统会定时推送新的物流信息。

注册后填写《用户接入表》（接入表下载网址/download），完善《用户信息登记表》、《物流数据需求表》这两个表格的内容，并发送到service@。

注册并提交《用户接入表》后可以参照如下进行开发对接：

2.1订阅接口对接描述/说明：

（1）此功能为专业定制，为特殊商户提供订阅服务，快递鸟系统会定时推送新的物流信息到商户系统。

（2）订阅快递号需指定相应的快递公司编码，格式不对或则编码错误都会返失败的信息。如：EMS物流单号应选择快递公司编码（EMS）查看快递公司编码

（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（4）请求系统级参数说明：

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。

（5）接口地址：

API地址：/Ebusiness/EbusinessOrderHandle.aspx

2.2推送接口(商户实现)

（1）客户需要按快递鸟要求开发接口，保证信息的正常接收。

（2）快递鸟主动推送时，物流信息接收接口由商户提供。

（3）接口支持的消息接收方式为HTTP POST，请求方法的编码格式(utf-8)："application/x-www-form-urlencoded;charset=utf-8"。

（4）运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。（5）请求系统级参数说明：

备注：R-必填（Required），O-可选（Optional），C-报文中该参数在一定条件下可选（Conditional）。

2.3接口参数

（1）请求内容字段定义

（2）返回参数定义

（3）推送接口(商户实现)

请求内容字段定义

返回参数定义

开发完成后联系在线客服进行接口双方联调，联调结束后就可以调用接口及接收物流轨迹了。