快递鸟物流跟踪 API 代码参数接入流程
物流追踪 API 提供物流订单监控服务,用户将订单内容订阅到快递鸟后,快递鸟对订单进行实时监控,当物流轨迹有更新时,实时获取数据,对数据进行格式化,计算运单预计到达时间、全流程的物流状态、当前所在城市等数据后,推送给用户。监控直到订单签收后结束。
应用场景
(1)电商网站用户打开“我的订单”时调用此 API 显示物流信息详情。
(2)电商管理后台的物流系统,客服在对账前查询所有运单的签收状态,并追踪问题。
(3)适用于日查询量>500 次的网站和系统。
功能说明
使用流程
API 参数
一、接口描述/说明
1.订阅接口
(1)此功能为专业定制,为特殊商户提供订阅服务,快递鸟系统会定时推送新的物流信息到商户系统。(2)订阅快递号需指定相应的快递公司编码,格式不对或则编码错误都会返失败的信息。如:EMS 物流单号应选择快递公司编码(EMS)查看快递公司编码
(3)接口支持的消息接收方式为 HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。(
4)接口地址: API 测试地址:http://sandboxapi.kdniao.com:8080/kdniaosandbox/gateway/exterfaceInvoke.jsonAPI正式地址:https://api.kdniao.com/api/dist
请求系统级参数说明:
2.推送接口(商户实现)
(1)客户需要按快递鸟要求开发接口,保证信息的正常接收。
(2)快递鸟主动推送时,物流信息接收接口由客户提供。
(3)接口支持的消息接收方式为 HTTP POST,请求方法的编码格式(utf-8):"application/x-www-form-urlencoded;charset=utf-8"。
(4)运单物流信息全量推送(每次推送的运单物流信息包括运单当前所有的的物流信息)。
请求系统级参数说明:
二、接口参数
1.订阅接口
请求内容字段定义:
返回参数定义:
2.推送接口
应用级输入参数
订阅查询结果(RequestType:101)
通过轨迹查询(订阅查询)接口订阅到快递鸟的数据,快递鸟推送时,会将推送的 RequestType 的值置为 101,同时返回下列数据
请求内容字段定义:
货款状态(RequestType:107)
用户通过电子面单使用快递鸟货到付款等金融服务时,快递鸟会将该订单的金融状态通过接口推送给用户。
请求内容字段定义:
返回参数定义
三、示例
订阅接口
请求示例 JSON
返回示例 JSON
推送接口(商户实现)
请求示例 JSON (订阅查询结果)
请求示例 JSON 格式 (货款状态)
返回示例 JSON
评论