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

来源:互联网 发布:网络音箱 编辑:程序博客网 时间:2024/04/28 15:13

之前有文章分析过快递物流信息的实时查询API接入,详细的介绍内容可以去这个地址逛逛:http://blog.csdn.net/cn_oo/article/details/52084926


这里就介绍一下快递物流信息的推送功能的接口对接分析:

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/),或者拨打快递网咨询电话:18205167920  或加qq:2885643506  发邮件至guoxiangyuan@kuaidi.com

0 0
原创粉丝点击