推送增量数据 java 数据推送接口

前言：

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

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

正文：

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

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"