快递100 API

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

POST

/api/query

请求示例

Shell

JavaScript

Java

Swift

curl --location -g --request POST 'http:///api/query' \
--data-urlencode 'key=' \
--data-urlencode 'num=' \
--data-urlencode 'sign='

响应示例

一、请求失败：
{
  "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"
    }
  ]
}

请求参数

Body 参数application/x-www-form-urlencoded

key

string

必需

贵司提供给快递100

num

string

运单号

必需

sign

string

必需

32位大写，MD5 ( key+ num + secret)的顺序进行加密，不需要加上“+”号，secret和key由贵司提供给快递100

返回响应

🟢200成功

application/json

Body

result

boolean

请求结果

必需

message

string

必需

state

integer

必需

轨迹当前状态，如：0在途，1揽收，2疑难，3签收，4退签，5派件，6退回，7转单，10待清关，11清关中，12已清关，13清关异常，14收件人拒签等

data

array [object {3}]

物流轨迹

必需

context

string

节点轨迹描述

必需

location

string

节点位置

必需

time

string

必需

节点时间，必须格式化为yyyy-MM-DD HH:mm:ss

电子面单接口示例

快递公司接入快递100订阅推送接口