万维易源-【按次计费】查询快递物流（同步）

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

累计调用

61亿+

快递接口交流群： 1056274608 查看演示

价格

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

非文件上传的POST时，请设置headers['Content-Type'] = 'application/x-www-form-urlencoded', 并把对象形式的数据转成查询字符串
文件上传的POST时，请设置headers['Content-Type'] = 'multipart/form-data'

1、系统级参数（所有接入点都需要的参数）：展开收起

参数名称	类型	示例值	必须	描述
showapi_appid	String	100	是	易源应用id
showapi_sign	String	698d51a19d8a121ce581499d7b701668	是	为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。可选【简单密钥方式】,在url后带上showapi_appid和showapi_sign即可
showapi_timestamp	String	20141114142239	否	客户端时间。格式yyyyMMddHHmmss,如20141114142239 为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。
showapi_res_gzip	String	1或0	否	返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。
...

2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起

参数名称	类型	示例值	必须	描述
com	String	yuantong	是	快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】
nu	String	YT4620020577123	是	单号
phone	String		否	手机尾号后四位，顺丰快递必须填写本字段【寄件人手机号或者收件人手机号】
...

三、返回参数/ 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，服务不存在或未上线 -7, API创建者的网关资源不足 -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受限 -1014，token权限无效
showapi_res_error	String	用户输入有误!	错误信息的展示
showapi_res_id	String	ce135f6739294c63be0c021b76b6fbff	本次请求id
...

2、应用级参数（系统级输出参数showapi_res_body字段中的json数据结构）： 展开收起

名称	类型	示例值	描述
update	Number	1588071235436	更新时间戳
upgrade_info	String		提示信息，用于提醒用户可能出现的情况
updateStr	String	2020-04-28 18:53:55	更新时间
logo	String	http://app2.showapi.com/img/expImg/zto.jpg	快递公司logo
dataSize	Number	11	数据节点的长度
status	Number	4	快递状态 1 暂无记录 2 在途中 3 派送中 4 已签收 5 用户拒签 6 疑难件 7 无效单 8 超时单 9 签收失败 10 退回
fee_num	Number	1	计费次数。例如：0为计费0次，即不计费；1为计费1次
tel	String	95311	快递公司联系方式
data	Object[]
- time	String	2019-11-16 21:33:56
- context	String	快件已在【九江城西港】签收, 签收人: 速递易, 如有疑问请电联:（15779254414）, 投诉电话:（13687028760）, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】
expSpellName	String	zhongtong	快递编码
msg	String	查询成功	返回提示信息
mailNo	String	75312165465979	快递单号
queryTimes	Number	1	无走件记录时被查询次数注意：在24小时内，查询次数>10次将会计费
ret_code	Number	0	0 查询成功或提交成功。 1 输入参数错误。 2 查不到物流信息。 3 单号不符合规则。 4 快递公司编码不符合规则。 5 快递查询渠道异常。 6 auto时未查到单号对应的快递公司,请指定快递公司编码。 7 单号与手机号不匹配其他参数：接口调用失败
flag	Boolean	true	true：查询成功，表示ret_code=0且data的长度>0。可使用本字段做是否读取data列表的依据。 false：查询失败。
expTextName	String	中通快递	快递简称
possibleExpList	String[]	[]	自动识别结果
...

四、请求示例/ Request example 查看使用向导查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

{
  "showapi_res_error": "",
  "showapi_res_code": 0,
  "showapi_res_id": "5ea916438d57baae126d08d7",
  "showapi_res_body": {
    "update": 1588071235436,
    "upgrade_info": "",
    "updateStr": "2020-04-28 18:53:55",
    "logo": "http://app2.showapi.com/img/expImg/zto.jpg",
    "dataSize": 11,
    "status": 4,
    "fee_num": 1,
    "tel": "95311",
    "data": [
      {
        "time": "2019-11-16 21:33:56",
        "context": "快件已在 【九江城西港】 签收, 签收人: 速递易, 如有疑问请电联:（15779254414）, 投诉电话:（13687028760）, 您的快递已经妥投。风里来雨里去, 只为客官您满意。上有老下有小, 赏个好评好不好？【请在评价快递员处帮忙点亮五颗星星哦~】"
      },
      {
        "time": "2019-11-16 07:31:24",
        "context": "【九江城西港】 的程继业（15779254414） 正在第1次派件, 请保持电话畅通,并耐心等待（95720为中通快递员外呼专属号码，请放心接听）"
      },
      {
        "time": "2019-11-16 07:31:23",
        "context": "快件已经到达 【九江城西港】"
      },
      {
        "time": "2019-11-15 19:06:30",
        "context": "快件离开 【九江】 已发往 【九江城西港】"
      },
      {
        "time": "2019-11-15 19:06:18",
        "context": "快件已经到达 【九江】"
      },
      {
        "time": "2019-11-15 10:45:21",
        "context": "快件离开 【南昌中转部】 已发往 【九江】"
      },
      {
        "time": "2019-11-15 08:02:44",
        "context": "快件已经到达 【南昌中转部】"
      },
      {
        "time": "2019-11-13 15:19:48",
        "context": "快件离开 【石家庄】 已发往 【南昌中转部】"
      },
      {
        "time": "2019-11-13 14:22:09",
        "context": "快件已经到达 【石家庄】"
      },
      {
        "time": "2019-11-13 14:08:31",
        "context": "快件离开 【石家庄市场部】 已发往 【石家庄】"
      },
      {
        "time": "2019-11-13 10:27:33",
        "context": "【石家庄市场部】（0311-68026565、0311-68026566） 的 付保文四组（031186891089） 已揽收"
      }
    ],
    "expSpellName": "zhongtong",
    "msg": "查询成功",
    "mailNo": "75312165465979",
    "queryTimes": 1,
    "ret_code": 0,
    "flag": true,
    "expTextName": "中通快递",
    "possibleExpList": []
  }
}

一个接口是一组接入点，每个接入点有自己的费率
资源包过期或用完，会立即失效
可购买多个资源包，会自动递延生效串联使用

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

1、接口介绍

2、使用场景

3、产品优势对比

4、我们的实力

5、合作伙伴

一、接入点/ API point

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

三、返回参数/ Return parameter

四、请求示例/ Request example 查看使用向导 查看我的showapi_appid与showapi_sign 丨

五、返回示例/ Return example

提供方联系方式/ Contact Information

易源·API市场

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