全国快递查询
服务商: 昆明秀派科技有限公司
电话: 400-998-8033
QQ: 3007663665
邮箱: services@showapi.com
使用快递单号实时查询物流信息轨迹,包括收件、运输、配送情况等。本接入点为阻塞式的同步调用。
应用场景:类似淘宝订单界面的快递物流轨迹查询,就可以用本功能实现。
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|---|---|---|---|---|
com | String |
zhongtong
|
是 | 快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息 如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号 【查询顺丰时,为了保证效率,请尽量提供寄件人或者收件人查询】 | |
nu | String |
75450632975559
|
是 | 单号 | |
phone | String | 否 | 手机尾号后四位,顺丰快递必须填写本字段【寄件人手机号或者收件人手机号】 |
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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[] |
[]
|
自动识别结果 |
{
"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": []
}
}
参数名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
showapi_res_body | String | {"city":"昆明","prov":"云南"} | 消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。 |
showapi_res_code | int | 0 | 查看错误码 |
showapi_res_error | String | 用户输入有误! | 错误信息的展示 |
showapi_res_id | String | ce135f6739294c63be0c021b76b6fbff | 本次请求id |
状态码 | 描述 |
---|---|
0 | 成功 |
-1 | 系统调用错误 |
-2 | 可调用次数或金额为0 |
-3 | 读取超时 |
-4 | 服务端返回数据解析错误 |
-5 | 后端服务器DNS解析错误 |
-6 | 服务不存在或未上线 |
-7 | API创建者的网关资源不足 |
-3 | 读取超时 |
-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权限无效 |