百度云-图像搜索

第三方服务商
价格:免费使用  
服务商: 万维易源
  • 产品介绍
  • 接口文档
  • 服务商
  • 官方客服

你好,这是一个图像搜索的模板连接器

下面将简单介绍一下百度只能云【图像搜索】API的功能

1.相似图片搜索

在自建图库中找到与检索图片语义相似的图片集,并给出相似度打分(综合图片类型、颜色、内容、布局等特征);适用于各种相似图片查找、相关内容推荐场景

2.相同图片搜索

在自建图库中找到与检索图相同的图片,支持找到局部内容相同的大图,或适度调整背景和角度的相同图片;可用于图片精确查找、重复图片过滤等场景

3.商品图片搜索

针对商品类图片,专项训练检索模型,在自建图库中搜索相同及相似的商品图片集,可找到不同颜色、背景、角度的同款商品;适用于电商平台拍照搜商品等场景

 

 

相似图-入库


接口地址:http://route.showapi.com/2053-1 (注意:接口支持https,更安全,但稍慢一些,你懂的。请根据自己的情况进行选择。)
支持格式:json
请求方法:HTTP协议,支持GET/POST方法。

二、请求参数/ Request parameter

非文件上传的POST时,enctype=application/x-www-form-urlencoded。 
文件上传的POST时,enctype=multipart/form-data。 

1、系统级参数(所有接入点都需要的参数): 

参数名称类型示例值必须描述
showapi_appidString100易源应用id
showapi_signString698d51a19d8a121ce581499d7b701668为了验证用户身份,以及确保参数不被中间人篡改,需要传递调用者的数字签名。 可选,在url后带上appid和secret即可 
showapi_timestampString20141114142239客户端时间。 
格式yyyyMMddHHmmss,如20141114142239 
为了在一定程度上防止“重放攻击”,平台只接受在10分钟之内的请求。如果不传或传空串,则系统不再做此字段的检测。 
showapi_res_gzipString1或0返回值是否用gzip方式压缩。此值为1时将压缩,其他值不压缩。
...

2、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起 

参数名称类型默认值示例值必须描述
imageString /9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url二选一,image优先级更高),注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。
urlString https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
briefString {"name":"美女", "id":"2"}检索时原样带回,最长256B。样例:{"name":"周杰伦", "id":"666"} 。请注意,检索接口不返回原图,仅返回入库时填写的brief信息,所以调用该入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
tagsString  tag间以逗号分隔,最多2个tag,2个tag无层级关系,检索时支持逻辑运算。样例:"100,11" ;检索时可圈定分类维度进行检索
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-1","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("brief","{\"name\":\"美女\", \"id\":\"2\"}") .addTextPara("tags","") .post(); System.out.println(res);

三、返回参数/ Return parameter

以JSON格式返回结果。

1、系统级参数(所有接入点都会返回的参数): 展开收起 

名称类型示例值描述
showapi_res_bodyString{"city":"昆明","prov":"云南"}消息体的JSON封装,所有应用级的返回参数将嵌入此对象 。
showapi_res_codeint0易源返回标志,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_errorString用户输入有误!错误信息的展示
showapi_res_idStringce135f6739294c63be0c021b76b6fbff本次请求id
...

2、应用级参数(系统级输出参数showapi_res_body字段中的json数据结构): 展开收起 

名称类型示例值描述
log_id Number2263663554唯一的log id,无实际意义,用于问题定位
cont_sign String4261577168,501945506输入图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途
...
返回示例:{ "log_id": 2263663554, "cont_sign": "4261577168,501945506" }

相似图-检索


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url二选一,image优先级更高,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式.
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image二选一,image优先级更高 ,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
tags String
分类维度信息,tag间以逗号分隔,最多可传入2个tag,2个tag无层级关系,检索时支持逻辑运算。示例:"100,11"
tag_logic String
检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn String
分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn String
分页功能,截取条数,例:250
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-2","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("tags","") .addTextPara("tag_logic","") .addTextPara("pn","") .addTextPara("rn","") .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_num Number
1
检索结果数
result Object[]
结果数组
0 Object
score Number
1
图片相关性,取值范围0-1,越接近1代表越相似
brief String
./data/jay1.jpg
add时添加的brief信息
cont_sign String
475124309,1080176642
图片签名,可以用来删除图片或定位问题
has_more String
false
是否还有下一页,返回值:true、false;如果不分页,不用关注该字段
log_id Number
1968648150
唯一的log id,用于问题定位
...
返回示例:{ "result_num": 1, "result": [ { "score": 0.97976700290421, "brief": "./data/jay1.jpg", "cont_sign": "475124309,1080176642" } ], "has_more": "false", "log_id": 1968648150 }

相似图-删除


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url、cont_sign三选一,优先级:image > url > cont_sign,注意要去掉图片头部,如(data:image/jpg;base64,)。最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,image优先级更高
cont_sign String
图片签名(和image、url三选一),支持批量删除,批量删除时请勿传image、url,最多支持1000个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-3","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id String
50488417
...
返回示例:{ "log_id": 50488417 }

相似图-更新


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url、cont_sign三选一,优先级:image > url > cont_sign,注意要去掉图片头部,如(data:image/jpg;base64,),要求base64编码后大小不超过4M,最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,优先级:image > url > cont_sign,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign String
图片签名,和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名,样例:"932301884,10680062193"
brief String
更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
tags String
更新的分类信息,tag间以逗号分隔,最多2个tag。样例:"100,11"
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-4","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .addTextPara("brief","") .addTextPara("tags","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
2263663554
唯一的log id,用于问题定位
...
返回示例:{ "log_id": 2263663554 }

相同图片-入库


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url二选一,image优先级更高),注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式。重复添加完全相同的图片会返回错误,提示不能重复入库。
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief String
检索时原样带回,最长256B。样例:{"name":"周杰伦", "id":"666"} 。请注意,检索接口不返回原图,仅返回入库时填写的brief信息,所以调用入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
tags String
tag间以逗号分隔,最多2个tag,2个tag无层级关系,检索时支持逻辑运算。样例:"100,11" ;检索时可圈定分类维度进行检索
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-5","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("brief","") .addTextPara("tags","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
2263663554
唯一的log id,无实际意义,用于问题定位
cont_sign String
4261577168,501945506
入库图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途
...
返回示例:{ "log_id": 2263663554, "cont_sign": "4261577168,501945506" }

相同图片-检索


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url二选一,image优先级更高),注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片
tags String
分类维度信息,tag间以逗号分隔,最多可传入2个tag,tag间无层级关系,示例:"100,11"
tag_logic String
检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn String
分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn String
分页功能,截取条数,例:250
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-6","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("tags","") .addTextPara("tag_logic","") .addTextPara("pn","") .addTextPara("rn","") .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_num Number
1
检索结果数
result Object[]
0 Object
score Number
1
图片相关性,取值范围0-1
brief String
./data/jay1.jpg
调用add接口时添加的brief信息,为保证该结果有效性,请入库时填写可关联至本地图片库的有效id信息
cont_sign String
475124309,1080176642
图片签名,可以用来删除图片或定位问题
has_more String
false
是否还有下一页,返回值:true、false;如果不分页,不用关注该字段
log_id Number
1968648150
唯一的log id,无实际含义,用于问题定位
...
返回示例:{ "result_num": 1, "result": [ { "score": 0.97976700290421, "brief": "./data/jay1.jpg", "cont_sign": "475124309,1080176642" } ], "has_more": "false", "log_id": 1968648150 }

相同图片-删除


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图片数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,(和url、cont_sign三选一,优先级:image > url > cont_sign),注意要去掉图片头部,如(data:image/jpg;base64,)。最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign String
图片签名(和image、url三选一),支持批量删除,批量删除时请勿传image、url,最多支持1000个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-7","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
50488417
唯一的log id,用于问题定位
...
返回示例:{ "log_id": 50488417 }

相同图片-更新


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图片数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M,和url、cont_sign三选一,优先级:image > url > cont_sign,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少50px,最长边最大4096px,支持jpg/png/bmp格式;重复添加会返回错误。
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,优先级:image > url > cont_sign ,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign String
图片签名,和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名,样例:"932301884,10680062193"
brief String
更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
tags String
更新的分类信息,tag间以逗号分隔,最多2个tag。样例:"100,11"
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-8","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .addTextPara("brief","") .addTextPara("tags","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
2263663554
唯一的log id,用于问题定位
...
返回示例:{ "log_id": 2263663554 }

商品图片-入库


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url二选一,image优先级更高,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式。重复添加会返回错误。
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image二选一,image优先级更高 ,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
brief String
检索时原样带回,最长256B。样例{"name":"周杰伦", "id":"666"} 请注意,检索接口不返回原图,仅返回当前填写的brief信息,所以调用入库接口时,brief信息请尽量填写可关联至本地图库的图片id或者图片url、图片名称等信息
class_id1 String
商品分类维度1,检索时可圈定该分类维度进行检索;只传入class_id1,则检索结果中包含class_id1内容的都会被检索到;同时传入class_id1与class_id2,则检索结果中同时包含class_id1和class_id2内容的才会被检索到
class_id2 String
商品分类维度2,检索时可圈定该分类维度进行检索 ,class_id1和class_id2无层级关系,检索时支持逻辑运算
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-9","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("brief","") .addTextPara("class_id1","") .addTextPara("class_id2","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
2263663554
唯一的log id,用于问题定位
cont_sign String
4261577168,501945506
上传图片的签名信息,请务必保存至本地,以便后续用作批量删除、查询某张图是否已经入过库等用途
...
返回示例:{ "log_id": 2263663554, "cont_sign": "4261577168,501945506" }

商品图片-检索


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。和url二选一,image优先级更高,注意要去掉图片头部,如(data:image/jpg;base64,),最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式。
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image二选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
class_id1 String
商品分类维度1,支持1-65535范围内的整数。
class_id2 String
商品分类维度2,支持1-65535范围内的整数。
tag_logic String
检索时tag之间的逻辑, 0:逻辑and,1:逻辑or
pn String
分页功能,起始位置,例:0。未指定分页时,默认返回前300个结果;接口返回数量最大限制1000条,例如:起始位置为900,截取条数500条,接口也只返回第900 - 1000条的结果,共计100条
rn String
分页功能,截取条数,例:250
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-10","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("class_id1","") .addTextPara("class_id2","") .addTextPara("tag_logic","") .addTextPara("pn","") .addTextPara("rn","") .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_num Number
1
检索结果数
result Object[]
结果数组
0 Object
score Number
1
图片相关性,取值范围0-1,越接近1代表越相似
brief String
./data/jay1.jpg
入库时添加的brief信息
cont_sign String
475124309,1080176642
图片签名,可以用来删除图片或定位问题
has_more String
false
是否还有下一页,返回值:true、false;如果不分页,不用关注该字段
log_id Number
1968648150
唯一的log id,用于问题定位
...
返回示例:{ "result_num": 1, "result": [ { "score": 0.97976700290421, "brief": "./data/jay1.jpg", "cont_sign": "475124309,1080176642" } ], "has_more" : "false", "log_id": 1968648150 }

商品图片-删除


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像数据,base64编码后进行urlencode,要求base64编码和urlencode后大小不超过4M。(和url、cont_sign三选一,优先级:image > url > cont_sign),注意要去掉图片头部,如(data:image/jpg;base64,)。要求base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,image优先级更高,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign String
图片签名(和image、url三选一,优先级最低),支持批量删除,批量删除时请勿传image、url,最多支持1000个cont_sign列表,样例:"932301884,1068006219;316336521,553141152;2491030726,1352091083"
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-11","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
50488417
唯一的log id,用于问题定位
...
返回示例:{ "log_id": 50488417 }

商品图片-更新


接口地址:http://route.showapi.com/2053-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述
image String
/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==
图像base64编码,和url、cont_sign三选一,优先级:image > url > cont_sign,注意要去掉图片头部,如(data:image/jpg;base64,),要求base64编码后大小不超过4M,最短边至少300px,最长边最大4096px,支持jpg/png/bmp格式
url String
https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg
图片URL,和image、cont_sign三选一,优先级:image > url > cont_sign,由于图床的差异性,抓图服务无法适配所有的图床,部分URL可能抓不到图,或者图片下载超时,遇到上述情况时请更换图片URL、或者将图片下载到本地转码后上传
cont_sign String
图片签名,和image、url三选一,优先级:image > url > cont_sign;不支持批量传入签名,样例:"932301884,10680062193"
brief String
更新的摘要信息,最长256B。样例:{"name":"周杰伦", "id":"666"}
class_id1 String
更新的商品分类1,支持1-65535范围内的整数。
class_id2 String
更新的商品分类2,支持1-65535范围内的整数。
...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/2053-12","my_appId","my_appSecret") .addTextPara("image","/9j/4AAQSkZJRgABAQEAAQABAAD/2wBDAAEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQH/2wBDAQEBAQ………………………………kZgsv9cPw88B393+zr4A0BW0yx8R/tC/Eb4e6jcJJDK8+iW8V4s8On6VYtLavb2MXh/wzptpNpTsi2Ut8ZPNcq0U/xuFlLFZhjsRytVqFWlCjW3UIThDmiov3Jb2vKLem9z2sbVpYbC4TBPSnWpVJ14czvOanJxfNfmjZW0i0vI//2Q==") .addTextPara("url","https://showapi.oss-cn-hangzhou.aliyuncs.com/modleapi/lzh/2.jpg") .addTextPara("cont_sign","") .addTextPara("brief","") .addTextPara("class_id1","") .addTextPara("class_id2","") .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数据结构): 展开收起
名称 类型 示例值 描述
log_id Number
2263663554
唯一的log id,用于问题定位
...
返回示例:{ "log_id": 2263663554 }

服务商介绍:易源数据是昆明秀派科技有限公司旗下的大数据生产、交易、流通平台。

易源数据通过打破资源壁垒,搭建起数据资源的基础设施,将接口纳入统一的接口池,把多个异构数据源合并到同一根管线上,以统一的访问和控制方式,对外提供统一格式的数据。

让开发者可以像搭积木一样通过各种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

 

 

 

 

 


其他服务商
热门API推荐
相关API推荐