连载篇提前看 前言
前两篇我们已经讲了TrackingMore和顺丰接口的场景应用和对接示例,本篇,将会对项目中如何使用快递100物流平台进行物流信息跟踪的对接进行一个全面详细的讲解。同样,我们会分为申请接入、物流信息订阅、物流消息推送、物流消息查询等几个步骤分别讲解。各位看官,请拿好你们的板凳和瓜子。我们要开始了,
接口申请进入快递100官网https://www.kuaidi100.com/
在快递接口(API)菜单中,我们可以看到接口申请这个菜单,点击进去会有免费版和企业版两种功能和资费介绍。
这里我们选择企业版,点击企业版,会要求填一些基本信息,我们按要求填完然后点击提交申请即可。
申请之后,有客服会通过联系方式联系所填号码,然后进行需求确认。这时候我们可以注册一个快递100的账号
注册完之后就可以进行登录了,登录之后在主页面,就可以看到再快递100平台中的账户余额情况,以及下面表格给出的可用的产品、服务等开通的状态(具体开通流程和客服取得联系之后他会协助你完成的),如下图所示
开通各个接口是需要快递100 那边进行审核的,审核通过之后会发邮件出来,附件里面会带有一些接口文档,截图如下:
其中 较为重要的是审核结果中会有一个分配好的Key密匙,请求接口的时候需要用到。所以需要妥善保管。
首先来看一下快递100 给出的订阅和推送的流向示意图
物流订阅
拿到接口文档相关秘籍和查阅请求调用流程图之后,我们便可以进行开发了,下面是物流订阅的相关示例步骤:
2.1订阅请求发起方:本服务用户,即贵公司
地址:
通信协议:HTTP
请求类型:POST
字符集:utf-8
请求内容:
schema= json/xml (或者xml,选择json则推送也是json,选择xml则推送也是xml,默认是json)
param=body
Body格式(json):
{
"company":"yuantong", //订阅的快递公司的编码,一律用小写字母,见章五《快递公司编码》
"number":"12345678", //订阅的快递单号,单号的最大长度是32个字符
"from":"广东省深圳市南山区", //出发地城市
"to":"北京市朝阳区", //目的地城市,到达目的地后会加大监控频率
"key":"*********", //授权码,签订合同后发放
"parameters":{
"callbackurl":" .您的域名.com/kuaidi?callbackid=...", //回调地址
"salt":"any string", //签名用随机字符串(可选)
"resultv2":"1" //添加此字段表示开通行政区域解析功能(仅对开通签收状态服务用户有效),见章3.1《推送请求》
}
}
Body格式(xml):
<?xml version='1.0' encoding='UTF-8'?>
<orderRequest>