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

2021-05-20 14:45:42 浏览数 (1)

请求地址

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

代码语言:txt复制
一、请求失败:
{
  "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

0 人点赞