ShowAPI,互联网API入口
立即注册

全国快递查询 官方自营 全部收费

 

全国快递信息查询接口,可查询国内外400多家快递或物流公司的运单信息,包括EMS、京东快递、顺丰、圆通、申通、韵达、德邦、中通、天天、汇通(百世)、宅急送...

浏览量: 848687

调用量: 1155365303

使用人数: 101743

¥ 0.01 元起

接入点说明: 根据提供的快递公司简称(编码)和运单号,追踪对应的收件、运输、配送情况
接口地址: http://route.showapi.com/64-19 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
返回格式: json
请求方式: HTTP协议,支持GET/POST方法。
调用样式及调试工具: 测试工具

查看加密签名方式 请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。
文件上传的POST时,enctype=multipart/form-data。

1、系统级参数(所有接入点都需要的参数):展开收起
参数名称 类型 示例值 必须 描述
showapi_appid String 100 易源应用id
showapi_sign String 698d51a19d8a121ce581499d7b701668 为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。
showapi_timestamp String 20141114142239 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。
showapi_res_gzip String 1或0 返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...
2、应用级参数(每个接入点有自己的参数):
参数名称 类型 默认值 示例值 必须 描述
com String
zhongtong
快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息 如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号
nu String
632671345422
单号

返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起
名称 类型 示例值 描述
showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_code int 0
易源返回标志,0为成功,其他为失败。
0成功
-1,系统调用错误
-2,可调用次数或金额为0
-3,读取超时
-4,服务端返回数据解析错误
-5,后端服务器DNS解析错误
-6,服务不存在或未上线
-1000,系统维护
-1002,showapi_appid字段必传
-1003,showapi_sign字段必传
-1004,签名sign验证有误
-1005,showapi_timestamp无效
-1006,app无权限调用接口
-1007,没有订购套餐
-1008,服务商关闭对您的调用权限
-1009,调用频率受限
-1010,找不到您的应用
-1011,子授权app_child_id无效
-1012,子授权已过期或失效
-1013,子授权ip受限
showapi_res_error String 用户输入有误! 错误信息的展示
showapi_res_id String ce135f6739294c63be0c021b76b6fbff 本次请求id
...
2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起
名称 类型 示例值 描述
expTextName String
快递公司名称
expSpellName String
公司英文
mailNo String
快递单号
update String
更新时间(时间戳)
tel String
联系电话
data String
快递配送信息
status Number
-1 待查询 0 查询异常 1 暂无记录 2 在途中 3 派送中 4 已签收
5 用户拒签
6 疑难件
7 无效单
8 超时单
9 签收失败
10 退回
possibleExpList possibleExpList[]
在auto的情况下,返回可能的快递列表simpleName快递简称、expName快递公司名
- simpleName String
shunfeng
快递公司的简称
- expName String
顺丰
快递名
ret_code String
0
接口调用是否成功,0:扣费,表示成功,-1:不扣费,表示渠道失败,例如网络失败、超时等
dataSize String
快递节点数量
msg String
返回说明
updateStr String
更新时间
flag String
true
成功或者失败的标识
...

返回示例/ Return example

{
  "showapi_res_error": "",
  "showapi_res_id": "83e10b52e3be4229a0d99e42975d4304",
  "showapi_res_code": 0,
  "showapi_res_body": {
    "expTextName": "中通快递",
    "mailNo": "632671345422",
    "dataSize": 11,
    "data": [
      {
        "time": "2018-05-14 12:47:32",
        "context": "【临沂市】  快件已在 【临沂莒南】 签收,签收人: 快递超市, 感谢使用中通快递,期待再次为您服务!"
      },
      {
        "time": "2018-05-14 10:46:43",
        "context": "【临沂市】  快件到达 【临沂莒南】"
      },
      {
        "time": "2018-05-14 08:11:51",
        "context": "【临沂市】  【临沂莒南】 的金都上城店(15762086855) 正在第2次派件, 请保持电话畅通,并耐心等待"
      },
      {
        "time": "2018-05-13 15:27:36",
        "context": "【临沂市】  快件离开 【临沂中转部】 发往 【临沂莒南】"
      },
      {
        "time": "2018-05-13 11:47:52",
        "context": "【临沂市】  快件到达 【临沂中转部】"
      },
      {
        "time": "2018-05-12 06:13:11",
        "context": "【广州市】  快件离开 【广州中心】 发往 【临沂中转部】"
      },
      {
        "time": "2018-05-12 05:51:06",
        "context": "【广州市】  快件到达 【广州中心】"
      },
      {
        "time": "2018-05-12 02:32:04",
        "context": "【深圳市】  快件离开 【深圳中心】 发往 【广州中心】"
      },
      {
        "time": "2018-05-12 02:30:33",
        "context": "【深圳市】  快件到达 【深圳中心】"
      },
      {
        "time": "2018-05-12 00:51:55",
        "context": "【深圳市】  快件离开 【福田新福星】 发往 【临沂中转部】"
      },
      {
        "time": "2018-05-11 19:58:38",
        "context": "【深圳市】  【福田新福星】(0755-83269390、0755-83387020) 的 佳义天吉·嘉顺仓储 (15751169008) 已揽收"
      }
    ],
    "ret_code": 0,
    "expSpellName": "zhongtong",
    "msg": "查询成功",
    "updateStr": "2018-08-21 10:26:29",
    "possibleExpList": [],
    "flag": true,
    "status": 4,
    "tel": "95311",
    "update": 1534818389551
  }
}