428384713476
- 产品介绍
- 接口文档
- 服务商
- 官方客服
全国快递信息查询接口，可查询国内外1000多家快递和物流公司的运单信息，包括EMS、京东快递、顺丰、圆通、申通、韵达、德邦、中通、天天、汇通（百世）、宅急送...
【用户调用次数太多了? 怎么节省费用？】
看下图...
1.效验数据,限制频率,减少用户无用的请求.
2.数据缓存.对有效数据进行缓存,建议0.5-2小时之间.同时,对应已经签收的订单,最少保留3天以上!
3.少用或不用auto来识别单号.单号识别是基于机器学习来识别的，由于没有国标，难免快递公司之间有重复或单号号段重叠的情况，所以单号识别不能保证100%准确,对于要求100%准确的用户,请不要使用auto自动识别单号的功能.
4.数据的扣费操作是根据showapi_res_body中的ret_code来判定的,当ret_code为0才进行扣费(也就是扣减调用次数),
其他情况下返回555的状态信息,且不进行扣费.简易的流程如下图:
5.如果您还是不知道如何节省,再简单粗暴点,看示意图:
快递物流跟踪
接口地址：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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 com String zhongtong 是 快递公司字母简称,可以从"快递公司列表"或"快递公司查询" 接口中查到该信息 如不知道快递公司名,可以使用"auto"代替,此时将自动识别快递单号 【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】 nu String 75312165465979 是 单号 senderPhone String 否 寄件人手机号后四位【手机号后四位填一个就行，多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】 receiverPhone String 否 收件人手机号后四位【手机号后四位填一个就行，多填以寄件人为准】、【请填写正确的信息、否则会查询不到】【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】 callBackUrl String 否 实时物流跟踪查询方式二（执行异步方式的开关），存在回调地址则执行异步任务 回调地址（http://www.xxxx.xxxx），请提交真实外网地址。 采用后扣费的方式，具体扣费规则和实时查询一样。 【查询顺丰时，为了保证效率，请尽量提供寄件人或者收件人查询】 contentType String bodyString bodyString 否 异步任务推送形式，bodyString：返回结果以{result:{},reqParams:{}}.toJsonString()的形式提交到body，form：post两个字段，第1个result（快递查询接果的json串），第2个reqParams（原始异步请求传来的信息json串）。 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-19","my_appId","my_appSecret") .addTextPara("com","zhongtong") .addTextPara("nu","75312165465979") .addTextPara("senderPhone","") .addTextPara("receiverPhone","") .addTextPara("callBackUrl","") .addTextPara("contentType","bodyString") .post(); System.out.println(res);
三、返回参数/ 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数据结构）： 展开收起
名称 类型 示例值 描述 expTextName String 快递公司名称 expSpellName String 公司英文 mailNo String 快递单号 update String 更新时间（时间戳） tel String 联系电话 data Object[] 快递配送信息 - time String 快递节点的时间 - context String 快递节点的描述 status Number -1 待查询 0 查询异常 1 暂无记录 2 在途中 3 派送中 4 已签收
5 用户拒签
6 疑难件
7 无效单
8 超时单
9 签收失败
10 退回
possibleExpList Object[] 在auto的情况下,返回可能的快递列表simpleName快递简称、expName快递公司名 - simpleName String shunfeng 快递公司的简称 - expName String 顺丰 快递名 ret_code String 0 接口调用是否成功,0:扣费，表示成功,-1:不扣费，表示渠道失败，例如网络失败、超时等 dataSize String 快递节点数量 msg String 返回说明 updateStr String 更新时间 flag String true 成功或者失败的标识 queryTimes String 当前快递单号每天查询总次数 ...
返回示例：{
"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
}
}
单号查快递公司
接口地址：http://route.showapi.com/64-21 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 nu String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-21","my_appId","my_appSecret") .addTextPara("nu","428384713476") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String msg String data String ...
返回示例：{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": 0,
"data": [
{
"simpleName": "zhongtong",
"expName": "中通快递"
},
{
"simpleName": "shunfeng",
"expName": "顺丰速运"
}
],
"msg": "操作成功!"
}
}
快递公司列表
接口地址：http://route.showapi.com/64-20 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 expName String 否 maxSize String 否 page String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-20","my_appId","my_appSecret") .addTextPara("expName","风") .addTextPara("maxSize","") .addTextPara("page","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 flag String expressList String expName String simpleName String url String note String phone String imgUrl String ret_code String ...
返回示例：{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": 0,
"flag": true,
"expressList": [
{
"imgUrl": "http://app2.showapi.com/img/expImg/rufeng.jpg",
"simpleName": "rufeng",
"phone": "400-010-6660",
"expName": "如风达快递",
"url": "http://www.rufengda.com",
"note": ""
},
{
"imgUrl": "http://app2.showapi.com/img/expImg/yafeng.jpg",
"simpleName": "yafeng",
"phone": "400-628-0018",
"expName": "亚风快递",
"url": "http://www.broad-asia.net",
"note": ""
},
{
"imgUrl": "http://app2.showapi.com/img/expImg/spring.jpg",
"simpleName": "spring",
"phone": "021-62968358",
"expName": "春风物流",
"url": "http://www.spring56.com/",
"note": ""
}
]
}
}
网点查询
接口地址：http://route.showapi.com/64-18 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 siteName String 否 addr String 否 contactInfo String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-18","my_appId","my_appSecret") .addTextPara("siteName","") .addTextPara("addr","") .addTextPara("contactInfo","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 expName String siteName String addr String contactInfo String sendInfo String ret_code String ...
返回示例：{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"flag": true,
"ret_code": 0,
"siteList": [
{
"addr": "官渡区大板桥镇工业园区188号",
"contactInfo": "总机：0871-68163777；传真：0871-67375088、67180745 世纪城：0871-67238760、63334884 东聚：0871-63983685；...",
"expName": "申通快递",
"sendInfo": "派送区域：昆明市五华区、官渡区（限区内）、西山区（限区内）、王家营、跑马山、洛阳镇。 不派送区域：碧鸡镇、团结镇。（注：村组一律不派送）",
"siteName": "云南昆明申通快递"
}
]
}
}
推送（订阅）地址测试
接口地址：http://route.showapi.com/64-27 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 url String 是 pushMethod String 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-27","my_appId","my_appSecret") .addTextPara("url","") .addTextPara("pushMethod","0") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code Number remark String showapi_fee_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "03833573c3554edcb864d7b5f33c84fd",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": "推送成功,请查看是否接收到信息！",
"showapi_fee_code": 0
}
}
设置推送（订阅）的回调地址
接口地址：http://route.showapi.com/64-22 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 callback_url String 是 pushMethod String 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-22","my_appId","my_appSecret") .addTextPara("callback_url","") .addTextPara("pushMethod","0") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String msg String updateTime String updateTimeStr String callback_url String callback_method String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "f34ae19c68b447d48ebc7ed0b67107a1",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"updateTime": "1561711425361",
"showapi_fee_code": 0,
"callback_method": "get",
"callback_url": "http://xxxxxx.com/ForTest/dodo",
"updateTimeStr": "2019-06-28 16:43:45.045",
"msg": "成功"
}
}
查询推送（订阅）的回调地址
接口地址：http://route.showapi.com/64-25 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-25","my_appId","my_appSecret") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String msg String updateTime String updateTimeStr String callback_url String callback_method String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "59aa5f51b9f7429f8d95e46bd670abea",
"showapi_res_code": 0,
"showapi_res_body": {
"updateTimeStr": "2018-08-28 09:56:01.001",
"msg": "成功",
"updateTime": "1535421361506",
"callback_url": "https://www.baidu.com",
"ret_code": 0
}
}
批量提交需要推送（订阅）的快递单号
接口地址：http://route.showapi.com/64-23 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 com_nu String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-23","my_appId","my_appSecret") .addTextPara("com_nu","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String msg String succ_count String updateTime String updateTimeStr String cant_expNo Object[] - com String - nu String - code String
1：快递编码为空
2：快递编码错误
3：快递单号为空
4：快递单号错误...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "88d8f3fb7db1450e91d72603cb9a7671",
"showapi_res_code": 0,
"showapi_res_body": {
"cant_expNo": [
{
"com": "shunfeng",
"nuList": [
"214115376"
],
"code": 4
}
],
"msg": "成功",
"updateTime": "1535422232932",
"succ_count": 2,
"updateTimeStr": "2018-08-28 10:10:32.1032",
"ret_code": 0
}
}
单次提交需要推送（订阅）的快递单号
接口地址：http://route.showapi.com/64-26 （注意：接口支持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 是 为了验证用户身份，以及确保参数不被中间人篡改，需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 showapi_timestamp String 20141114142239 否 客户端时间。
格式yyyyMMddHHmmss,如20141114142239
为了在一定程度上防止“重放攻击”，平台只接受在10分钟之内的请求。如果不传或传空串，则系统不再做此字段的检测。showapi_res_gzip String 1或0 否 返回值是否用gzip方式压缩。此值为1时将压缩，其他值不压缩。 ... 2、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 com String 是 nu String 是 senderPhone String 否 receiverPhone String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/64-26","my_appId","my_appSecret") .addTextPara("com","") .addTextPara("nu","") .addTextPara("senderPhone","") .addTextPara("receiverPhone","") .post(); System.out.println(res);
三、返回参数/ Return parameter
以JSON格式返回结果。
1、系统级参数（所有接入点都会返回的参数）： 展开收起
名称 类型 示例值 描述 showapi_res_body String {"city":"昆明","prov":"云南"} 消息体的JSON封装，所有应用级的返回参数将嵌入此对象 。 showapi_res_code int 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数据结构）： 展开收起
名称 类型 示例值 描述 ret_code String msg String updateTime String updateTimeStr String nu String com String ...
返回示例：{
"showapi_res_error":"",
"showapi_res_id":"88d8f3fb7db1450e91d72603cb9a7671",
"showapi_res_code":0,
"showapi_res_body":{
"nu":"9977994497950",
"ret_code":0,
"com":"gnxb",
"updateTime":"1535964370397",
"updateTimeStr":"2018-09-03 16:46:10.4610",
"msg":"成功"
}
}
服务商介绍：易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。
易源数据通过打破资源壁垒，搭建起数据资源的基础设施，将接口纳入统一的接口池，把多个异构数据源合并到同一根管线上，以统一的访问和控制方式，对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种API操纵资源。
截至2017年12月，平台已经拥有API接口230个，日调用量2000万，覆盖全网10万+真实消费者，为超过3000+的企业用户提供全域数据服务。
联系方式：
电话： 4009988033
微博： http://www.weibo.com/showapi
邮箱： services@showapi.com
QQ： 3007663665
微信： show_api
进制数据介绍：
企业和程序员可以通过进制数据封装的API或SDK极速接入其他数据资源，同时进制数据提供数据交易等服务。通过进制数据，不仅开发成本极大降低，而且可以获得其他丰富的数据服务：数据交易，数据分析，区块链Token管理等服务。
联系我们：
电话：173-6457-5198
QQ① 群：792473404
客服 QQ：1643296538
微信客服：binstds
扫描二维码添加客服微信
工作时间：
周一至周五 9：00 - 21：00（其中周三为 9:00 - 18:00）
周六 9:00 - 12:00（节假日除外）
进制数据团队
2020.01.01