接口地址:http://route.showapi.com/1934-1 (注意:接口支持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 shunfeng 是 快递编码 time String 否 寄件时间,格式:yyyy-MM-dd HH:mm,默认当前时间 origin_pro String 云南省 是 原寄地-省名、直辖市 origin_city String 昆明市 是 原寄地-市名、直辖市的区县名字 origin_county String 嵩明县 否 原寄地-区县 dest_pro String 重庆市 是 目的地-省名、直辖市 dest_city String 秀山土家族苗族自治县 是 目的地-市名、直辖市的区县名字 dest_county String 否 目的地-区县 chang String 否 体积-长(cm)、体积和质量必填一个 kuang String 否 体积-宽(cm)、体积和质量必填一个 gao String 否 体积-高(cm)、体积和质量必填一个 weight String 否 质量(kg)、体积和质量必填一个 ...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1934-1","my_appId","my_appSecret") .addTextPara("com","shunfeng") .addTextPara("time","") .addTextPara("origin_pro","云南省") .addTextPara("origin_city","昆明市") .addTextPara("origin_county","嵩明县") .addTextPara("dest_pro","重庆市") .addTextPara("dest_city","秀山土家族苗族自治县") .addTextPara("dest_county","") .addTextPara("chang","") .addTextPara("kuang","") .addTextPara("gao","") .addTextPara("weight","") .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数据结构): 展开收起
名称 类型 示例值 描述 result Object[] 返回结果集 - 0 Object - time String 2019-11-24 12:00 前 预计时效 - currencyName String 人民币 币种 - weight Number 1 质量 - price Number 23 价格 - weightUnit String kg 单位 - freightName String 顺丰标快 产品 ret_code Number 0 0为成功,并且扣除一次费用,其余失败,不扣费 showapi_fee_code Number 0 其他平台编码,本平台忽略 msg String 查询成功! 返回说明 ...
返回示例:{
"result": [
{
"time": "2019-11-24 12:00 前",
"currencyName": "人民币",
"weight": 0.6,
"price": 23,
"weightUnit": "kg",
"freightName": "顺丰标快"
},
{
"time": "2019-11-24 23:59 前",
"currencyName": "人民币",
"weight": 0.3,
"price": 18,
"weightUnit": "kg",
"freightName": "顺丰特惠"
},
{
"time": "已过最晚收件时间",
"currencyName": "人民币",
"weight": 0.6,
"price": 25,
"weightUnit": "kg",
"freightName": "顺丰次晨"
}
],
"ret_code": 0,
"showapi_fee_code": 0,
"msg": "查询成功!"
}
接口地址:http://route.showapi.com/1934-2 (注意:接口支持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/1934-2","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为成功,其他为失败。
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数据结构): 展开收起
名称 类型 示例值 描述 result Object[] 返回结果集- 0 Object - com String shunfeng 快递编码- expTextName String 顺丰速运 快递简称ret_code Number 0 0为成功,并且扣除一次费用,其余失败,不扣费showapi_fee_code Number 0 其他平台编码,本平台忽略...
返回示例:{
"result": [
{
"com": "shunfeng",
"expTextName": "顺丰速运"
}
],
"ret_code": 0,
"showapi_fee_code": 0
}
易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种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