本api旨在为不太了解前端js或者不想写前端js的开发人员提供一个简单易用的参数定制图表,支持常规的线图、饼图、柱图、面积图以及特有的文字云图。开发者使用仅需像其他api一样传参即可取到一个html的iframe代码片段,将该片段插入要展现图表的页面即可。详情请见基本资料页面API说明部分。
接口地址:http://route.showapi.com/322-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 data String [["谷歌","http://www.goolge.cn",20000],["百度","http://www.baidu.com",10000],["Bing","http://www.bing.com",8000],["搜狗搜索","http://www.sogou.com/",6000],["好搜","http://www.haosou.com/",3000]] 是 图表数据,格式为JSON的二维数组。子数组中第一个元素为显示文本、第二个元素为链接网址、第三个元素为显示权重(权重越大显示的字体越大),第四个元素为tip中的描述(本例没有传该元素)。需要按权重进行从大到小的排序 title String 图表示例 否 图表标题 descript String 图表描述 否 以灰色小字显示在标题下方 backgroundColor String 125,125,125,0 否 图表背景,RGBA颜色,前三段为红绿蓝颜色,第四段为透明度 width String 否 图表iframe的宽度,使用数值。不设置将使用父容器的宽度 height String 否 参见宽度说明 center String [50,50] 否 文字云中心位置,格式为JSON的一维数值数组,第一个元素为x坐标的百分比数值、第二个元素为y坐标的百分比数值 size String [40,40] [80,80] 否 文字云尺寸比,格式为JSON的一维数值数组,第一个元素为宽度的百分比数值、第二个元素为高度的百分比数值。都相对于整个图而言 textRotation String [0,45,-45,90] 否 文本可选的旋转角度,格式为JSON的一维数值数组,每个元素代表一个可用的旋转角度。为显示美观不建议修改 minFontSize String 12 否 最小文本大小 textPadding String 0 否 文本之间的间距 ...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/322-4","my_appId","my_appSecret") .addTextPara("data","[[\"谷歌\",\"http://www.goolge.cn\",20000],[\"百度\",\"http://www.baidu.com\",10000],[\"Bing\",\"http://www.bing.com\",8000],[\"搜狗搜索\",\"http://www.sogou.com/\",6000],[\"好搜\",\"http://www.haosou.com/\",3000]]") .addTextPara("title","图表示例") .addTextPara("descript","图表描述") .addTextPara("backgroundColor","125,125,125,0") .addTextPara("width","") .addTextPara("height","") .addTextPara("center","") .addTextPara("size","[80,80]") .addTextPara("textRotation","") .addTextPara("minFontSize","") .addTextPara("textPadding","") .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数据结构): 展开收起
名称 类型 示例值 描述 ret_code Number 0 错误码 errorMsg String 错误信息(本接口只校验了必填项,格式并没有校验。请严格按照参数描述传参) iframe String html iframe代码 ...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"iframe": "<iframe src='http://static.showapi.com/uploader/chart/20150724/103ac12b-dd4e-4bde-9fd2-bf0a2ce0e8f0.html' frameborder='no' border='0' scrolling='no' allowtransparency='yes' style='height: 100%;width:100%;background:transparent;'></iframe>",
"ret_code": 0
}
}
接口地址:http://route.showapi.com/322-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 data String [{center:[30,30],data:{"good":1302,"normal":3453,"bad":3212}},{center:[70,70],radius:[30,40],roseType:"radius",data:{"good":1302,"normal":3453,"bad":3212}}]是 图表数据,标准JSON对象格式数组,每个元素对应一个饼图. 元素内部属性有center,data,radius, roseType. center为饼的中心位置的百分比数值[X,Y];data为饼图数据;radius为饼图的内半径与外半径; roseType为饼图类型,可以使用radius和area或空字符串; 请参照示例使用title String 示例图表否 图表标题descript String 本图数据纯属虚构否 以灰色小字显示在标题下方backgroundColor String 125,125,125,0否 图表背景,RGBA颜色,前三段为红绿蓝颜色,第四段为透明度width String 否 图表iframe的宽度,使用数值。不设置将使用父容器的宽度height String 否 参见宽度说明showToolbox String 否 默认将显示图表工具箱,不需要显示则传falseshowLegend String 否 默认将显示图例,不需要显示则传falseroseType String 否 玫瑰图标识,可选的值为radius、area,不传该参数表示显示为默认饼图...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/322-3","my_appId","my_appSecret") .addTextPara("data","[{center:[30,30],data:{\"good\":1302,\"normal\":3453,\"bad\":3212}},{center:[70,70],radius:[30,40],roseType:\"radius\",data:{\"good\":1302,\"normal\":3453,\"bad\":3212}}]") .addTextPara("title","示例图表") .addTextPara("descript","本图数据纯属虚构") .addTextPara("backgroundColor","125,125,125,0") .addTextPara("width","") .addTextPara("height","") .addTextPara("showToolbox","") .addTextPara("showLegend","") .addTextPara("roseType","") .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数据结构): 展开收起
名称 类型 示例值 描述 ret_code Number 0 错误码errorMsg String 错误信息(本接口只校验了必填项,格式并没有校验。请严格按照参数描述传参)iframe String html iframe代码...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"errorMsg": "",
"iframe": ""
}
}
接口地址:http://route.showapi.com/322-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 cateGoryData String ["one","tow","three","four","five","six"]是 类目型X轴的类目数据,格式为标准的JSON 字符串数组。注意使用英文标点符号title String 示例图表否 图表标题descript String 图表描述否 以灰色小字显示在标题下方backgroundColor String 125,125,125,0否 图表背景,RGBA颜色,前三段为红绿蓝颜色,第四段为透明度yAxisFormatter String {value}℃否 Y轴和tip中显示用的格式化字符串,显示时将使用实际数值替换{value}width String 否 图表iframe的宽度,使用数值。不设置将使用父容器的宽度height String 否 参见宽度说明showToolbox String 否 默认将显示图表工具箱,不需要显示则传falseshowLegend String 否 默认将显示图例,不需要显示则传falsesmooth String 否 默认曲线为折线,如需要平滑曲线请传入truestack String 否 默认为非堆积曲线,如需要显示堆积曲线请传入trueshowArea String 否 默认显示曲线图,如需要显示面积图请传入truechartType String 否 默认显示曲线图,如需要初始显示柱图请传入bardata String [{name:"线1",data:[12,53,33,1,45,5,59,3]},{name:"线2",data:[34,136,65,3,2,56,55,22,76,33,5,31,9]}]是 图表数据,格式为标准JSON对象数组,每个元素表示一条曲线,请参照示例使用...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/322-2","my_appId","my_appSecret") .addTextPara("cateGoryData","[\"one\",\"tow\",\"three\",\"four\",\"five\",\"six\"]") .addTextPara("title","示例图表") .addTextPara("descript","图表描述") .addTextPara("backgroundColor","125,125,125,0") .addTextPara("yAxisFormatter","{value}℃") .addTextPara("width","") .addTextPara("height","") .addTextPara("showToolbox","") .addTextPara("showLegend","") .addTextPara("smooth","") .addTextPara("stack","") .addTextPara("showArea","") .addTextPara("chartType","") .addTextPara("data","[{name:\"线1\",data:[12,53,33,1,45,5,59,3]},{name:\"线2\",data:[34,136,65,3,2,56,55,22,76,33,5,31,9]}]") .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数据结构): 展开收起
名称 类型 示例值 描述 ret_code Number 0 错误码errorMsg String 错误信息(本接口只校验了必填项,格式并没有校验。请严格按照参数描述传参)iframe String html iframe代码...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"errorMsg": "",
"iframe": ""
}
}
接口地址:http://route.showapi.com/322-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 title String 示例图表否 图表标题descript String 这是一个示例图表否 以灰色小字显示在标题下方backgroundColor String 125,125,125,0否 图表背景,RGBA颜色,前三段为红绿蓝颜色,第四段为透明度yAxisFormatter String {value}℃否 Y轴和tip中显示用的格式化字符串,显示时将使用实际数值替换{value},默认值为{value}。当Y轴为时间时将忽略该参数width String 否 图表iframe的宽度,使用数值。不设置将使用父容器的宽度height String 否 参见宽度说明showToolbox String 否 默认将显示图表工具箱,不需要显示则传falseshowLegend String 否 默认将显示图例,不需要显示则传falsesmooth String 否 默认曲线为折线,如需要平滑曲线请传入trueshowArea String 否 默认显示曲线图,如需要显示面积图请传入truechartType String 否 默认显示曲线图,如需要初始显示柱图请传入barxAxisFormatter String 否 X轴和tip中显示用的格式化字符串,显示时将使用实际数值替换{value},默认值为{value}。当X轴为时间时将忽略该参数xAxisType String time否 X轴类型,默认为value。可选为timeyAxisType String 否 Y轴类型,默认为value。可选为timedata String [{name:'测试数据',data:[[1436287383431, 10], [1436287385431, 7], [1436287387431, 8], [1436287389431, 6], [1436287391431, 12], [1436287392431, 9], [1436287395431, 6], [1436287397431, 4], [1436287399431, 9]]}]是 图表数据,标准JSON对象格式数组,每个元素对应一条曲线. 元素内name表示曲线名称;元素内data为曲线数据的数组,每个曲线数据对应[X轴数据,Y轴数据],如果对应的坐标轴为时间类型,则数据使用时间戳. 请参照示例使用...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/322-1","my_appId","my_appSecret") .addTextPara("title","示例图表") .addTextPara("descript","这是一个示例图表") .addTextPara("backgroundColor","125,125,125,0") .addTextPara("yAxisFormatter","{value}℃") .addTextPara("width","") .addTextPara("height","") .addTextPara("showToolbox","") .addTextPara("showLegend","") .addTextPara("smooth","") .addTextPara("showArea","") .addTextPara("chartType","") .addTextPara("xAxisFormatter","") .addTextPara("xAxisType","time") .addTextPara("yAxisType","") .addTextPara("data","[{name:\'测试数据\',data:[[1436287383431, 10], [1436287385431, 7], [1436287387431, 8], [1436287389431, 6], [1436287391431, 12], [1436287392431, 9], [1436287395431, 6], [1436287397431, 4], [1436287399431, 9]]}]") .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数据结构): 展开收起
名称 类型 示例值 描述 ret_code Number 0 错误码errorMsg String 错误信息(本接口只校验了必填项,格式并没有校验。请严格按照参数描述传参)iframe String html iframe代码...
返回示例:{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_body": {
"ret_code": "0",
"errorMsg": "",
"iframe": ""
}
}
易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。
让开发者可以像搭积木一样通过各种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