文档中心
手机号查询快递接口示例

手机app快递查询接口

接口描述

手机查快递接口,通过收寄人手机接口获取该渠道三个月内快递单信息。

请求地址

POST

http://xx.com/api/query/phone

请求头

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

请求体

参数名是否必填类型说明
keystring接入方在平台的api账户标识
phonestring手机号码
signstring签名, 用于验证身份, 按(key+phone+secret )的顺序进行MD5加密(注意加密后字符串一定要转大写), 不需要加上“+”号
typenumber类型 0:所有,1:发件人,2:收件人 3:既是发件人也是收件人
sizenumber返回最近的单号轨迹数量

返回结果

字段名称类型是否必填字段含义
resultboolean请求结果
messagestring消息体
dataarray[object]业务数据

data类型说明

字段名称类型是否必填字段含义
typenumber1:寄件人;2:收件人;3:既是发件人也是收件人
numstring运单号
detailsarray[object]物流轨迹实体类

details类型说明

字段名称类型是否必填字段含义
contextstring节点轨迹描述
locationstring轨迹所在地区行政区,如:广东深圳南山
timestring节点时间,必须格式化为 yyyy-MM-dd HH:mm:ss

提供数据说明

一、请求失败
{
  "result": false,
  "message": "手机号码格式错误",
  "data": null
}


二、请求成功,但是查无结果
{
  "result": true,
  "message": "查无结果",
  "data": []
}

三、请求成功,有单号
{
  "result": true,
  "message": "SUCCESS",
  "data": [
    {
      "type": 2,
      "num": "UT0000280482232",
      "details": [
        {
          "context": "【深圳转运中心】,正发往【深圳南山区十六部】",
          "location": "广东省深圳市",
          "time": "2018-04-29 16:31:48"
        },
        {
          "context": "到【东莞凤岗中心分部集货点】",
          "location": "广东省东莞市",
          "time": "2018-04-29 11:23:18"
        }
      ]
    },
    {
      "type": 1,
      "num": "UT0000280482235",
      "details": [
        {
          "context": "站点【退货部】进行了【货物退回客户扫描】操作",
          "location": "江苏省南京市玄武区",
          "time": "2018-04-29 18:01:22"
        },
        {
          "context": "【南京玄武网点】的小哥郑义正在派件",
          "location": "江苏省南京市玄武区",
          "time": "2018-04-29 10:17:26"
        }
      ]
    }
  ]
}