拍照并识别照片中的物体,并返回京东商城对应相同或相似商品的信息,大幅提升搜索速度和准确度,增加拍照和购物乐趣,目前支持数十个大类及数千个类目,可用于电商场景,手机终端,准确可靠,转化率高。
依托京东线上线下多个零售场景现实数据,利用业界先进的AI算法技术,能够支持家电数码,食品饮料,个护化妆,箱包,配饰,鞋靴,上衣等数十个大类及数千个类目。
经过京东商城及第三方合作厂家数亿万次的调用业务验证,稳定可靠,识别精确。
可满足电商场景下的商品识别,也可支持手机终端厂商的相机模块,拍照购物,增加用户的购物乐趣。
功能简介:检测图片中的商品
功能详述:基于用户上传的图片,检测图片中的商品。
功能简介:检索图片中的商品
功能详述:用户上传包含物品的日常图片,经过后台服务器处理,返回京东商城中与上传图片中某一主体视觉相似的商品列表。
公测期间调用量上限:无
公测期间流量上限:30/QPS
电商场景通过调用拍照购,识别商品库中相同或相似商品,返回对应的商品信息。
手机终端通过相机对商品进行拍照,识别商品并返回对应的商品信息。
其他场景其他涉及拍照并识别照片中的物体,返回京东商城对应相同或相似商品信息的场景。
接口地址:http://route.showapi.com/1959-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、应用级参数(每个接入点有自己的参数,当前接入点的参数见下表): 展开收起
参数名称 类型 默认值 示例值 必须 描述 imgBase64 String /9j/4AAQSk... 是 图片base64编码,图片像素:最小 128 * 128 图片大小:小于 3M channel_id String test 是 业务方识别码(channel_id=test 每日最大调用量为500次) ...
请求示例:String res=new ShowApiRequest("http://route.showapi.com/1959-1","my_appId","my_appSecret") .addTextPara("imgBase64","/9j/4AAQSk...") .addTextPara("channel_id","test") .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数据结构): 展开收起
名称 类型 示例值 描述 jd_ret Object 京东云返回体 - charge Object false:不扣费, true:扣费 - code String 10000 参见错误码-系统级错误码 - msg String 查询成功 参见错误码-系统级错误码 - remain Number 0 按天计算剩余调用次数 - remainSeconds Number -1 - remainTimes Number -1 - result Object 查询结果 - channel_id String test 业务方识别码(与输入相同) - dataValue Object[] 返回商品信息 - 0 Object 参见错误码-业务级错误码 - rectangle Object 商品框和商品类目信息 - bottom String 749 商品框下方值(右下角坐标y值) - cls Number 300 类目信息 - clsName String 全部 返回结果类目中文名称 - isUserRectangle String 1 是否是用户框选(暂不支持) - left String 1 商品框左侧值(左上角坐标x值) - right String 749 商品框右侧值(右下角坐标x值) - top String 1 商品框上方值(左上角坐标y值 - sims Object[] 相似商品列表信息 - 0 Object - cls Number 300 返回结果类目信息 - clsName String 全部 返回结果类目中文名称 - detailAppUrl String https://item.m.jd.com/product/34038827648.html 商品详情页信息(JD.COM) - detailUrl String https://item.jd.com/34038827648.html APP端商品详情页 - dis Number 1 商品图与用户上传图像相似度距离 - imageUrl String https://img11.360buyimg.com/img/jfs/t25210/289/1641162460/564097/1fd689d1/5bb81d54N0d633fb8.jpg 商品主图jfs地址 - similarity Number 0 商品图与用户上传图像相似度 - skuId Number 34038827648 商品sku ID - skuName String Nike耐克2018夏季新款 AIR MAX 97 SE炫彩 三原色 女子子弹头气垫运动休闲鞋跑步鞋 921733-102 白红子弹 37.5 商品名称 - skuPrice String 3429.00 商品价格 - wareLabel String 非自营 有自营/非自营/京东物流/京东精选 四种商品销售渠道可供选择 - img_height Number 750 图像高度 - img_width Number 750 图像宽度 - main_category_list String 300|3|14|8|4|5|2|6|9|0|1|7|13|10|11|12 类目预测排序,根据分类置信度排序 - main_category_names String 全部|鞋靴|其他|配饰|箱包|数码家电|下衣|食品饮料|个护洗化|裙装|上衣|玩具乐器|绿植|家居家装|手机|图书影音 与类目列表对应的中文名称 - message String Interface Succeed! 参见错误码-业务级错误码 - query_id String 08ff5dbab0f309000425b4078a27b41b 用户请求query唯一标识字段 - status String 0 参见错误码-业务级错误码 remark String 接口调用是否成功提示信息 ret_code Number 0 接口调用是否成功,0为成功,其他为失败 ...
返回示例:{
"showapi_res_error": "",
"showapi_res_id": "0f6540bd22624bc087b07d242e46caf1",
"showapi_res_code": 0,
"showapi_res_body": {
"jd_ret": {
"charge": false,
"code": "10000",
"msg": "查询成功",
"remain": 0,
"remainSeconds": -1,
"remainTimes": -1,
"result": {
"channel_id": "test",
"dataValue": [
{
"rectangle": {
"bottom": "749",
"cls": 300,
"clsName": "全部",
"isUserRectangle": "1",
"left": "1",
"right": "749",
"top": "1"
},
"sims": [
{
"cls": 300,
"clsName": "全部",
"detailAppUrl": "https://item.m.jd.com/product/34038827648.html",
"detailUrl": "https://item.jd.com/34038827648.html",
"dis": 0.8226532388315261,
"imageUrl": "https://img11.360buyimg.com/img/jfs/t25210/289/1641162460/564097/1fd689d1/5bb81d54N0d633fb8.jpg",
"similarity": 0.0008328709910390439,
"skuId": 34038827648,
"skuName": "Nike耐克2018夏季新款 AIR MAX 97 SE炫彩 三原色 女子子弹头气垫运动休闲鞋跑步鞋 921733-102 白红子弹 37.5",
"skuPrice": "3429.00",
"wareLabel": "非自营"
}
]
}
],
"img_height": 750,
"img_width": 750,
"main_category_list": "300|3|14|8|4|5|2|6|9|0|1|7|13|10|11|12",
"main_category_names": "全部|鞋靴|其他|配饰|箱包|数码家电|下衣|食品饮料|个护洗化|裙装|上衣|玩具乐器|绿植|家居家装|手机|图书影音",
"message": "Interface Succeed!",
"query_id": "08ff5dbab0f309000425b4078a27b41b",
"status": "0"
}
},
"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