快递物流信息推送功能接口分析

Posted 2020-08-20

前言：

快递物流信息的跟踪接口分为两种方式：一种是实时的查询跟踪（主动）；一种是订阅推送跟踪（被动）。

实时查询（主动）是指主动发出查询请求，返回实时的物流信息数据；订阅推送（被动）是指把需要跟踪的快递物流单号提交给查询服务商，当单号有物流信息的更新时，查询服务商把物流信息数据推送给用户。

实时查询跟踪的方式前面已经有文章介绍过了：快递查询API

 

正文：

这里主要简单的介绍一下订阅推送功能：

1.做一个简单的示意图分析：（自己做的，比较粗略）

 

快递信息推送服务由订单订阅、跟踪系统和订单推送组成。用户系统通过调用订单订阅，将要需要跟踪的运单号提交给查询服务商，查询服务商在接收到运单信息之后就会对这些运单的状态进行跟踪。当运单状态发生变化的时候，便通过调用订单推送功能，将快递单查询结果推送给用户系统，直到该运单号的生命周期结束（通常情况下以“已签收”为准）。

2.订阅接口协议

以一家查询服务商为例

 

2.1订阅请求

 

发起方:用户系统

地址:http://highapi.kuaidi.com/openapi-receive.html

通信协议:HTTP

请求类型:POST

字符集:utf-8

请求内容:

param=body

 

 

要传入内容，只显示核心的字段，非核心的已隐藏

Body格式(json)：

{

"company":"yuantong",//订阅的快递公司的编码，一律用小写字母，

"number":"12345678", //订阅的快递单号，单号的最大长度是32个字符

"from":"广东深圳",//出发地城市

"to":"北京朝阳",//目的地城市，到达目的地后会加大监控频率

"key":"*********",//授权码，需要联系查询服务商注册账号ID

"parameters":{

"callbackurl":"http://www.您的域名.com/kuaidi?callbackid=...",//回调地址

"salt":"any string",//签名用随机字符串（可选）

}

}

2.2订阅返回

由查询服务商直接通过订阅请求的response返回。

返回内容，只显示核心的字段，非核心的已隐藏（以JSON为例）

"message":"success"

 

 

 

备注：

更多的详细的内容不在这里过多的写了，有需要了解的可自行到百度网盘下载查看，下载地址为：https://pan.baidu.com/s/1mhMmlNa

下载文档里附带有快递公司的简码列表。

如果有什么不清楚的地方，请到快递网的官网咨询（http://www.kuaidi.com/），或者拨打快递网咨询电话：[phone]  或加qq:2885643506  发邮件至[email protected]