快递公司接入快递100的快递实时查询接口示例

原创

快递100API

修改于 2021-05-20 14:45:42

8020

修改于 2021-05-20 14:45:42

文章被收录于专栏：程序员也要懂业务

请求地址

POST

http://xx.com/api/query

请求头

名称	类型	默认值
Content-Type	string	application/x-www-form-urlencoded

请求体

名称	是否必填	类型	说明
key	是	string	贵司提供给快递100
num	是	string	运单号
sign	是	string	32位大写，MD5 ( key+ num + secret)的顺序进行加密，不需要加上“+”号，secret和key由贵司提供给快递100

响应数据

名称	是否必填	类型	说明
result	是	boolean	请求结果
message	是	string
state	是	string	轨迹当前状态，如：0在途，1揽收，2疑难，3签收，4退签，5派件，6退回，7转单，10待清关，11清关中，12已清关，13清关异常，14收件人拒签等
Θdata	是	array	物流轨迹
└context	是	string	节点轨迹描述
└location	否	string	节点位置
└time	是	string	节点时间，必须格式化为yyyy-mm-dd hh:mm:ss

接口描述

实时获取运单轨迹

编码：UTF-8

一、请求失败：
{
  "result": false,
  "message": "验签失败",
  "data": []
}

二、请求成功，没有物流轨迹：
{
  "result": true,
  "message": "运单号不存在",
  "data": []
}

三、请求成功，有物流轨迹：
{
  "result": true,
  "message": "SUCCESS",
  "state":0,
  "data": [
    {
      "context": "站点【退货部】进行了【货物退回客户扫描】操作",
      "location": "",
      "time": "2018-04-29 16:31:48"
    },
    {
      "context": "快件到达【退货部】,上一站是【北京分拣中心】",
      "location": "",
      "time": "2018-04-03 14:26:25"
    },
    {
      "context": "快件离开【北京分拣中心】,发往【C应急二】",
      "location": "",
      "time": "2018-03-07 01:21:28"
    },
    {
      "context": "【北京分拣中心】收件入库,交货方是【快乐购北京】",
      "location": "北京",
      "time": "2018-03-07 00:55:26"
    }
  ]
}

官方文档：

https://api.kuaidi100.com/document/60509213a52d305ab4d2a1cb.html

原创声明：本文系作者授权腾讯云开发者社区发表，未经许可，不得转载。

如有侵权，请联系 cloudcommunity@tencent.com 删除。

java