- 一个接口是一组接入点,每个接入点有自己的费率
- 资源包过期或用完,会立即失效
- 可购买多个资源包,会自动递延生效串联使用
yuantong
电商平台用于跟踪快递物流轨迹。
便民服务平台用于提供给用户查询快递,作为增值服务提升用户活跃度。
比如银行到给客户寄银行卡和账单,保险公司给客户寄合同,需要对快递投递进度和状态进行跟踪,也方便客户查看快递进度。
专注全域API服务, 您的支持就是我们最大的肯定
让网络数据像水、电一样, 使用容易、自由和便宜
已为3000多家企业提供API服务
非文件上传的POST时,请设置headers['Content-Type'] = 'application/x-www-form-urlencoded',
并把对象形式的数据转成查询字符串
文件上传的POST时,请设置headers['Content-Type'] = 'multipart/form-data'
参数名称 | 类型 | 示例值 | 必须 | 描述 |
---|---|---|---|---|
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时将压缩,其他值不压缩。 |
... |
参数名称 | 类型 | 默认值 | 示例值 | 必须 | 描述 |
---|---|---|---|---|---|
com | String |
yuantong
|
是 |
快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息
如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号
【查询顺丰时,为了保证效率,请尽量提供寄件人或者收件人查询】
|
|
nu | String |
YT4620020577123
|
是 |
单号
|
|
phone | String |
|
否 |
手机尾号后四位,顺丰快递必须填写本字段【寄件人手机号或者收件人手机号】
|
|
... |
以JSON格式返回结果。
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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 |
... |
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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
电话: 4009988033
微博: http://www.weibo.com/showapi
邮箱:
QQ: 3007663665
微信: show_api (公众号)