myoutcode
- 产品介绍
- 接口文档
- 服务商
- 官方客服
易源OAuth2子授权，可通过应用appid创建无数个子授权access_token，这样在客户端可以使用access_token访问具备权限的接口，不再需要在客户端中放置appid和secret，提高安全性。
由于一个appid可以创建无限量个子授权，为防止滥用，本接口收取一定低额费用。
1.背景介绍
您在调用易源接口时，简单签名方式是把appid和secret附在url后即可，比如【手机归属地查询】接口，其代码样式如下：
- https://route.showapi.com/6-1?num=18908711111&showapi_appid=xxx&showapi_sign=xx
调用时需要传输appid和secret进行鉴权。调用流程如下图所示：
上图中，客户端获取数据时要从用户服务器上中转，这样加大了用户服务器的负荷压力，也增加了带宽流量。能不能让客户端直连易源平台呢？我们来看下这个流程：
2.易源子授权
如上所示，可用，但不安全。我们来看下此问题的解决方案：【易源OAuth2子授权】接口。它允许您使用appid创建子授权access_token，并可细粒度控制子授权的权限，比如调用并发、ip白名单、可调用的接口列表等。下面是使用子授权的流程图：
在使用子授权时，您调用易源接口的方式如下：
- https://route.showapi.com/6-1?num=18908711111&access_token=xxxxxxxx
注意其中的 access_token参数，可以在header、get或post结构中运行传输。
3.完整流程
查询子授权分页记录
接口地址：http://route.showapi.com/2141-5 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 out_code String myoutcode 否 子授权的唯一编码，通常对应于客户端系统中的的用户id。 page Number 1 1 否 第几页。每页最多返回20条记录。
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-5","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .addTextPara("page","1") .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数据结构）： 展开收起
名称 类型 示例值 描述 allNum Number 1 共多少条记录。 contentlist Object[] 分页中的数据列表。 - 0 Object - expires_in Number 2591829 - access_token String 22fbb5a75f80946b595aed84a5f47a5459fd52f992b5abc554aea4f813699319 - rate Number 3 - appid Number 258 - out_code String myoutcode - ip_white_list String[] [] remark String ret_code Number 0 currentPage Number 1 当前页。 allPages Number 1 总页数。 maxResult Number 20 每页最多返回多少条记录。 ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "a084b7aa79344455ae4ecf5ece6c42bc",
"showapi_res_code": 0,
"showapi_res_body": {
"allNum": 1,
"contentlist": [
{
"permission_list": "6-1,32-*,",
"expires_in": 7043,
"end_time": "2019-10-22 00:35:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
}
],
"remark": "",
"ret_code": 0,
"currentPage": 1,
"allPages": 1,
"maxResult": 20
}
}
创建子授权
接口地址：http://route.showapi.com/2141-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 out_code String 是 rate Number 3 否 ip_white_list String 否 expires_in Number 7200 否 permission_list String 否 grant_type String Client Credentials 否 remark String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-1","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .addTextPara("rate","3") .addTextPara("ip_white_list","") .addTextPara("expires_in","7200") .addTextPara("permission_list","6-1,32-*") .addTextPara("grant_type","Client Credentials") .addTextPara("remark","") .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数据结构）： 展开收起
名称 类型 示例值 描述 item Object - expires_in Number - access_token String - rate Number - appid Number - out_code String - ip_white_list Object[] remark String ret_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "3acf476dcf214883856f404c73cb54a3",
"showapi_res_code": 0,
"showapi_res_body": {
"item": {
"permission_list": "6-1,32-*,",
"expires_in": 7137,
"end_time": "2019-10-22 00:35:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
},
"remark": "",
"ret_code": 0
}
}
延长子授权时效
接口地址：http://route.showapi.com/2141-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 out_code String 是 add_seconds Number 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-2","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .addTextPara("add_seconds","60") .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数据结构）： 展开收起
名称 类型 示例值 描述 remark String fresh_item Object - expires_in Number - access_token String - rate Number - appid Number - out_code String - ip_white_list String ret_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "81339eec3cf64fee8f4eaccd3ac641f0",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"fresh_item": {
"permission_list": "6-1,32-*,",
"expires_in": 7055,
"end_time": "2019-10-22 00:36:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
},
"ret_code": 0
}
}
删除子授权
接口地址：http://route.showapi.com/2141-3 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 out_code String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-3","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .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数据结构）： 展开收起
名称 类型 示例值 描述 del_item Object - expires_in Number - permission_list String - access_token String - rate Number - appid Number - out_code String - ip_white_list String remark String ret_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "5769f848ae944b14949587cf17180525",
"showapi_res_code": 0,
"showapi_res_body": {
"del_item": {
"permission_list": "6-1,32-*,",
"expires_in": 7030,
"end_time": "2019-10-22 00:36:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
},
"remark": "",
"ret_code": 0
}
}
查看单个子授权明细
接口地址：http://route.showapi.com/2141-4 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 out_code String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-4","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .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数据结构）： 展开收起
名称 类型 示例值 描述 item Object - expires_in Number - access_token String - rate Number - appid Number - out_code String - ip_white_list String[] remark String ret_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "d8b82d9811b045aaabdb505cb60934f4",
"showapi_res_code": 0,
"showapi_res_body": {
"item": {
"permission_list": "6-1,32-*,",
"expires_in": 7017,
"end_time": "2019-10-22 00:35:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
},
"remark": "",
"ret_code": 0
}
}
更新子授权权限
接口地址：http://route.showapi.com/2141-6 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 out_code String 是 rate Number 否 ip_white_list String 否 permission_list String 否 remark String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/2141-6","my_appId","my_appSecret") .addTextPara("out_code","myoutcode") .addTextPara("rate","3") .addTextPara("ip_white_list","") .addTextPara("permission_list","6-1,32-*") .addTextPara("remark","") .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数据结构）： 展开收起
名称 类型 示例值 描述 item Object - expires_in Number - access_token String - rate Number - appid Number - out_code String - ip_white_list Object[] remark String ret_code Number ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "3acf476dcf214883856f404c73cb54a3",
"showapi_res_code": 0,
"showapi_res_body": {
"fresh_item": {
"permission_list": "6-1,32-*,",
"expires_in": 7102,
"end_time": "2019-10-22 00:35:15",
"access_token": "3d3a3060ae2810e7395fa6c07b8dc5d1b6e2cdecfd618d768fd59a68f62dda12",
"rate": 3,
"appid": 258,
"out_code": "myoutcode",
"ip_white_list": ""
},
"remark": "",
"ret_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