实时查询接口示例

实时查询接口示例

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

请求地址

POST

http://xx.com/api/query

请求头

名称类型默认值
Content-Typestringapplication/x-www-form-urlencoded

请求体

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

响应数据

名称是否必填类型说明
resultboolean请求结果
messagestring
statestring轨迹当前状态,如:0在途,1揽收,2疑难,3签收,4退签,5派件,6退回,7转单,10待清关,11清关中,12已清关,13清关异常,14收件人拒签等
Θdataarray物流轨迹
└contextstring节点轨迹描述
└locationstring节点位置
└timestring节点时间,必须格式化为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"
    }
  ]
}
实时查询接口示例