user
- 产品介绍
- 接口文档
- 服务商
- 官方客服
本连接器可将您的MySQL数据库接口转化为HTTP接口，大大提升开发效率。包括增删查改以及数据库级别的建表、建索引等所有指令。也可以自定义SQL语句并嵌入变量的方式调用。
1. 背景与问题
1.1 MySQL是什么
MySQL官网地址是： https://www.mysql.com/ ，其特点如下：
- MySQL是一个关系型数据库管理系统，由瑞典MySQL AB 公司开发，目前属于 Oracle 旗下产品。MySQL 是最流行的关系型数据库管理系统之一，在 WEB 应用方面，MySQL是最好的 RDBMS (Relational Database Management System，关系数据库管理系统) 应用软件之一。
- MySQL是一种关系数据库管理系统，关系数据库将数据保存在不同的表中，而不是将所有数据放在一个大仓库内，这样就增加了速度并提高了灵活性。
- MySQL所使用的 SQL 语言是用于访问数据库的最常用标准化语言。MySQL 软件采用了双授权政策，分为社区版和商业版，由于其体积小、速度快、总体拥有成本低，尤其是开放源码这一特点，一般中小型网站的开发都选择 MySQL 作为网站数据库。
1.2 常规使用流程
我们在使用各种语言的驱动连接MySQL时，常规流程如下图所示：
虽然最终数据库是同一个，但每种语言都有对应的驱动程序，操作方式不尽相同。
1.3 面临的问题
1.3.1 开发者门槛高，有一定的学习曲线，对于快速迭代、验证型项目成本较高
目前越来越多的人参与到软件开发中，项目规模可能不大，但几乎都会涉及到数据库应用，而关系数据库MySQL就是一个非常好的选择。这些大量的开发者并不会太关心数据库原理、数据库范式等底层核心内容，他们关心的是怎么样高效地完成【增删查改】操作，越简单完成业务越好，让机器去做生活中的重复无趣操作从而提升效率。
很多项目中用户数不多，甚至只有1个（自用型），这样的情况下要求入门开发者去了解数据库原理、驱动操作就有点为难，毕竟开发出来的软件服务的是业务而不是技术。这种时候开发速度比成熟度、性能更为重要，因为成熟度和性能是可以不断优化提升的，而产品的上线时间是一个DeadLine。
1.3.2 驱动的版本管理
当项目需要连接多个版本的MySQL时（比如老系统改造，系统二次开发），此问题尤为严重，驱动包的冲突会导致开发管理成本上升。
1.3.3 多项目、多语言环境下交互复杂，代码重复率高，维护困难
2.解决方案
- 通过易源MySQL连接器，您可以用HTTP接口操作您自己的MySQL数据库，比如增删查改等CRUD操作，也可以说您的数据库被“HTTP”化了。
- 易源已经将一些常见SQL操作封装成API接入点，通过几步简单的配置操作，就可以在代码中通过HTTP请求使用MySQL数据库。
- 您可以轻松摆脱语言、驱动、框架的约束，只用简单的写几句代码就可以实现对数据库的操作。
- 在实际使用时，调用者只需要关心调用地址、输入参数、输出参数 三个元素，具体实现细节不需要关注，比如后端是MySQL还是MongoDB，是txt还是csv，只要这个后端实现了同样的调用地址、输入参数、输出参数三元素即可。这样的特性非常适合于前后端分离开发。
通常稍大的软件产品，都会划分为多个子项目（比如用户使用的前端系统、后台管理系统等）。
如果使用易源平台操作MySQL，其流程如下图所示：
易源的MySQL连接器将MySQL数据库转化为通用数据源，并可以使用http接口进行全部数据库操作，包括但不限于增、删、查、改方法。
2.1 创建表
通过HTTP接口创建表，详情操作请点此查看。
2.2 查看所有表
通过HTTP接口查看所有的数据表，详情操作请点此查看。
2.3 插入记录
通过HTTP接口插入一条记录，详情操作请点此查看。
2.4 更新记录
通过HTTP接口更新多条记录，详情操作请点此查看。
2.5 删除记录
通过HTTP接口删除记录，详情操作请点此查看。
2.6 查询列表
通过HTTP接口查询数据列表，最高返回1000条记录，详情操作请点此查看。
2.7 查询分页
通过HTTP接口查询分页记录，返回结构包含当前页、总页数、总记录数、当前页数据列表。分页虽不难，但历来都是繁琐操作（如果自己封装）使用易源的HTTP操作可以瞬间让您的程序具备分页查询功能。详情操作请点此查看。
2.8 自定义SQL语句
如果我们需要用到复杂的SQL语句，在易源可以预先设置。比如说一段100行的复杂SQL代码，里面嵌入变量，这些变量从客户端用HTTP传入。SQL语句和变量您都可以自由定制。您可以使用本功能完成几乎所有的MySQL操作。详情操作请点此查看。
3. 性能问题
以前是直连MySQL，现在是通过易源进行中转，您可能会对这个流程的性能提出质疑，回答如下：
- 不考虑网络因素，在同一个局域网下进行压力测试，直连时程序做充分优化，易源中转比直连方式的多消耗时间<=1ms。网站或APP的响应时间在100ms-1000ms之间是可以接受的，也就是易源增加的时间是整体流程的0.01至0.001的比率，几乎可以忽略不计。这点开销，就像开车从北京到西安有1000公里，中间因为修路多走了1公里，总共由1000到1001公里，多走这1公里对全局可以忽略不计。
- 程序直连的性能取决于数据库和客户端的优化。比如客户端程序是否使用连接池、连接参数是怎么样的，都会对测试性能产生不小的影响。而在很多情况下，客户端的程序是缺乏优化的，甚至很多程序根本不使用连接池。使用易源转发就不存在这个问题，易源默认连接池，并会动态根据繁忙情况动态调整参数，因此很多时候使用易源还会带来更高的性能。
总结：您不需要为性能担忧，对于优化得当的老鸟来说易源会慢千分之一，但对于普通开发者来说易源可能更快。
4. 安全问题
- 易源平台和您签定合作协议，易源保证关键信息加密存储，保证数据安全不泄露，保证无用户授权绝对不连接数据源。
- 易源公布对外IP，您可以设置IP白名单。对于MySQL连接器，易源的IP是：
-
- 121.41.60.109
- 120.26.59.160
- 120.26.61.225
- 129.211.129.137
show-tables
接口地址：http://route.showapi.com/27-13 （注意：接口支持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/27-13","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数据结构）： 展开收起
名称 类型 示例值 描述 table_list String 返回所有数据表列表。 ret_code String 0为操作成功 ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "a30e73bd43474efd91a5f3c491558bdf",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"table_list": [
"newtable",
"user",
"user33"
],
"ret_code": 0
}
}
select-one
接口地址：http://route.showapi.com/27-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 fields String * 否 where String 否 where_param String 否 order_by String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-5","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("fields","id,name") .addTextPara("where","name=? and age=?") .addTextPara("where_param","[\"张三\",30]") .addTextPara("order_by","id desc") .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数据结构）： 展开收起
名称 类型 示例值 描述 one String ret_code String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "5b106d39a66f44d4a3031680e806b392",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"one": {
"age": 123,
"name": "dssss",
"id": 24
},
"ret_code": 0
}
}
select-one高级
接口地址：http://route.showapi.com/27-15 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 id Number 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-15","my_appId","my_appSecret") .addTextPara("id","3") .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数据结构）： 展开收起
名称 类型 示例值 描述 one String ret_code String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "5b106d39a66f44d4a3031680e806b392",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"one": {
"age": 123,
"name": "dssss",
"id": 24
},
"ret_code": 0
}
}
select-list
接口地址：http://route.showapi.com/27-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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 fields String * 否 where String 否 where_param String 否 order_by String 否 limit Number 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-6","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("fields","id,name") .addTextPara("where","name=? and age=?") .addTextPara("where_param","[\"张三\",30]") .addTextPara("order_by","id desc") .addTextPara("limit","10") .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数据结构）： 展开收起
名称 类型 示例值 描述 list String ret_code String ret_num String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "0cb04751e056485b9600edf07d9e2b40",
"showapi_res_code": 0,
"showapi_res_body": {
"list": [
{
"id": 32,
"name": "李四"
},
{
"id": 31,
"name": "李四"
},
{
"id": 24,
"name": "张三2222"
},
{
"id": 22,
"name": "张三2222"
},
{
"id": 3,
"name": "张三2222"
}
],
"remark": "",
"ret_code": 0,
"ret_num": 5
}
}
select-count
接口地址：http://route.showapi.com/27-7 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 where String 否 where_param String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-7","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("where","name=? and age=?") .addTextPara("where_param","[\"张三\",30]") .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数据结构）： 展开收起
名称 类型 示例值 描述 count_num String ret_code String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "09cd9d79b11649149c9da6fdd246a5ab",
"showapi_res_code": 0,
"showapi_res_body": {
"count_num": 5,
"remark": "",
"ret_code": 0
}
}
select-distinct
接口地址：http://route.showapi.com/27-8 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 where String 否 where_param String 否 distinct String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-8","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("where","name=? and age=?") .addTextPara("where_param","[\"张三\",30]") .addTextPara("distinct","*") .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数据结构）： 展开收起
名称 类型 示例值 描述 list String ret_code String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "1b828ea4993e4cf2bd8e64133013d9f3",
"showapi_res_code": 0,
"showapi_res_body": {
"list": [
{
"age": 30,
"name": "张三2222",
"id": 3
},
{
"age": 156,
"name": "张三2222",
"id": 22
},
{
"age": 123,
"name": "张三2222",
"id": 24
},
{
"age": 28,
"name": "李四",
"id": 31
},
{
"age": 28,
"name": "李四",
"id": 32
}
],
"remark": "",
"ret_code": 0
}
}
update
接口地址：http://route.showapi.com/27-9 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 where String 否 where_param String 否 set_data String 否 set_param String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-9","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("where","name=? and age=?") .addTextPara("where_param","[\"张三\",30]") .addTextPara("set_data","name=?") .addTextPara("set_param","[\"张三\"]") .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数据结构）： 展开收起
名称 类型 示例值 描述 affected_rows String ret_code String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "5574352cf69940a4ad252b3fff9d0467",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"ret_code": 0,
"affected_rows": 1
}
}
insert
接口地址：http://route.showapi.com/27-10 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 table String 是 insert_data Object 否
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-10","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("insert_data","{\"name\":\"李四\",\"age\":28}") .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数据结构）： 展开收起
名称 类型 示例值 描述 insert_id String ret_code String affected_rows String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "7bbf128b64b34161804c7d25d0974bc5",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": "",
"insert_id": 31,
"affected_rows": 1
}
}
insert高级
接口地址：http://route.showapi.com/27-16 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 name String 是 age Number 是 table String 是 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-16","my_appId","my_appSecret") .addTextPara("name","李四") .addTextPara("age","28") .addTextPara("table","test") .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数据结构）： 展开收起
名称 类型 示例值 描述 insert_id String ret_code String affected_rows String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "7bbf128b64b34161804c7d25d0974bc5",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": "",
"insert_id": 31,
"affected_rows": 1
}
}
delete
接口地址：http://route.showapi.com/27-11 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）： 展开收起
参数名称 类型 默认值 示例值 必须 描述 table String 是 where String 否 where_param String 否 ...
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-11","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("where","id=?") .addTextPara("where_param","[23]") .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 affected_rows String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "3b1ab4d647584a14aa6d29058999cc64",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"ret_code": 0,
"affected_rows": 0
}
}
create-table
接口地址：http://route.showapi.com/27-12 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 table String 是 fields_param String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-12","my_appId","my_appSecret") .addTextPara("table","user") .addTextPara("fields_param","{\"age\":\"int\",\"name\":\"varchar(255)\",\"address\":\"varchar(255)\"}") .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 ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "b1a17fa5ebc44320a22bcf9ae5d80cf3",
"showapi_res_code": 0,
"showapi_res_body": {
"remark": "",
"ret_code": 0
}
}
drop-table
接口地址：http://route.showapi.com/27-14 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 table String 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-14","my_appId","my_appSecret") .addTextPara("table","test") .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 ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "853e0efd4aac4b13af2bb30935da4e3c",
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": ""
}
}
自定义sql
接口地址：http://route.showapi.com/27-17 （注意：接口支持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、应用级参数（每个接入点有自己的参数,当前接入点的参数见下表）：
参数名称 类型 默认值 示例值 必须 描述 id Number 是
请求示例：String res=new ShowApiRequest("http://route.showapi.com/27-17","my_appId","my_appSecret") .addTextPara("id","1") .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数据结构）： 展开收起
名称 类型 示例值 描述 list String ret_code String ret_num String ...
返回示例：{
"showapi_res_error": "",
"showapi_res_id": "0cb04751e056485b9600edf07d9e2b40",
"showapi_res_code": 0,
"showapi_res_body": {
"list": [
{
"id": 32,
"name": "李四"
},
{
"id": 31,
"name": "李四"
},
{
"id": 24,
"name": "张三2222"
},
{
"id": 22,
"name": "张三2222"
},
{
"id": 3,
"name": "张三2222"
}
],
"remark": "",
"ret_code": 0,
"ret_num": 5
}
}
服务商介绍：易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。
易源数据通过打破资源壁垒，搭建起数据资源的基础设施，将接口纳入统一的接口池，把多个异构数据源合并到同一根管线上，以统一的访问和控制方式，对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种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