酒标识别
一、接口描述
1. 功能描述
发送图片二进制数据,直接返回葡萄酒识别结果信息。
2. 能力说明
- 图片格式:jpg/jpeg、png
- 图片像素尺寸:最小 100 100 像素,最大 3000 3000 像素
- 图片文件大小:最小 2KB,最大 4MB
3. 接口使用
使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址
https://aiapi.jd.com/9kacha/imsapi
2. 请求方式
post
三、返回说明
1、返回参数
(1)公共返回参数
名称 |
类型 |
示例值 |
描述 |
code |
string |
1000 |
参见下方错误码-系统级错误码 |
charge |
boolean |
false 或 true |
false:不扣费, true:扣费 |
remainTimes |
long |
1305 |
剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds |
long |
1223456 |
剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg |
string |
查询成功 |
参见下方错误码-系统级错误码数 |
result |
object |
{...} |
查询结果 |
(2)业务返回参数
字段 |
类型 |
字段说明 |
status |
string |
返回结果,'0'表示成功,其他值为不成功,错误信息见description |
description |
string |
描述值。包括正确和错误描述 |
command |
string |
命令号,与请求的command一致 |
search_id |
string |
搜索ID。可用于跟踪搜索信息 |
image_url |
string |
提交图片链接地址。 |
wineinfo |
array |
商品ID信息,格式:[{},{}]。 |
wine_list |
array |
商品数据信息:格式:[{},{}]。 |
advert |
array |
广告信息。格式:[{},{}]。 |
字段 |
类型 |
字段说明 |
wine_id |
string |
商品ID |
sign |
string |
商品ID对应的签名值。 |
year |
string |
商品的年份。 |
- wine_list“商品数据信息”数组中单个元素的结构:
字段 |
类型 |
字段说明 |
wine_id |
string |
商品ID |
sign |
string |
商品ID对应的签名值。 |
wyear |
string |
商品的年份。 |
name_ch |
string |
商品中文名称。 |
name_en |
string |
商品英文名称。 |
country |
string |
商品对应的国家。 |
region |
string |
商品对应的产区。 |
sub_region |
string |
商品对应的子产区。 |
winery |
string |
酒庄。 |
type |
string |
酒类型。 |
sugar |
string |
糖分。 |
grape |
array |
葡萄品种。格式:
[{“name”:”葡萄1”},{“name”:”葡萄2”}]。 |
grade |
array |
机构评分。格式:[{},{}]。 |
grade_url |
string |
机构评分链接地址。 |
taste_temp |
string |
侍酒温度。 |
color |
string |
颜色。 |
recipe_pair |
string |
配餐。 |
wine_desc |
string |
酒品描述。 |
pic_url |
string |
商品的图片链接。 |
wine_url |
string |
商品对应的H5介绍页面链接地址。 |
buyInfo |
array |
购买信息。格式:[{},{}]。 |
moreBuyUrl |
string |
更多购买链接地址。 |
star_rating |
array |
其他年份咔嚓评分指数。格式:
[{“year”:”年份”,”score”:”分值”,”total”:”条数”},…]。 |
currStarRating |
object |
当前年份的咔嚓评分指数。格式:
{“year”:”年份”,”score”:”分值”,”total”:”条数”}。 |
referPrice |
object |
参考价格,比如:230-299 |
字段 |
类型 |
字段说明 |
name_ch |
string |
葡萄品种中文名 |
name_en |
string |
葡萄品种中英名。 |
web_url_ch |
string |
葡萄品种介绍url。 |
字段 |
类型 |
字段说明 |
RP |
string |
罗伯特•帕克《葡萄酒倡导家》。 |
WS |
string |
《葡萄酒观察家》。 |
WE |
string |
《葡萄酒爱好者》杂志。 |
DE |
string |
《品醇客》(Decanter)葡萄酒杂志。 |
字段 |
类型 |
字段说明 |
ec_platform_id |
string |
电商平台ID |
ec_unique_id |
string |
电商平台商品唯一ID(SKU_ID)。 |
buy_url |
string |
购买链接。 |
year |
string |
年份。 |
capacity |
string |
容量。如:750ML。 |
price |
string |
商品价格。单瓶价。 |
all_price |
string |
商品价格。购买链接的总价格。 |
wine_count |
string |
商品数量。 |
currency |
string |
币种。 |
retailer_id |
string |
提供商品ID。 |
retailer_name |
string |
提供商名称。 |
retailer_logo_url |
string |
提供商LOGO链接。 |
字段 |
类型 |
字段说明 |
title |
string |
标题名称 |
description |
string |
文字描述说明。 |
picurl |
string |
图片描述说明。 |
adurl |
string |
广告页面链接地址。 |
2. 返回示例
{
"code": "10000",
"charge": false,
"remainTimes": 4998,
"remainSeconds": -1,
"msg": "查询成功",
"result": {
"command":"10000",
"status":"0",
"description":"搜索成功",
"search_id":"v4em1ye3-20375-25048700-1505753683",
"image_url":"http://staticfs1.9kacha.com/image/0bc7a021957e571a052f9456dbba913e/thumb",
"wineinfo":[
{
"wine_id":"064921199",
"sign":"633c46e496cb2caad497eb333e496925C910A7AFCCE0EA11C71E728F734BEA52",
"year":"2008"
}
],
"wine_list":[
{
"wine_id":"064921199",
"name_ch":"拉菲古堡红葡萄酒(正牌)",
"name_en":"Chateau Lafite Rothschild",
"sign":"633c46e496cb2caad497eb333e496925C910A7AFCCE0EA11C71E728F734BEA52",
"wyear":"2008",
"year":"2008",
"country":"法国",
"region":"波尔多",
"sub_region":"梅多克",
"winery":"拉菲古堡",
"color":"深紫红色",
"grape":[
{
"name":"美乐"
},
{
"name":"品丽珠"
},
{
"name":"赤霞珠"
}
],
"grade":[
{
"year":"2008",
"RP":"97",
"WS":"92",
"WE":"",
"DE":"19.0",
"JR":"17.5"
}
],
"taste_temp":"18-22℃",
"pic_url":"http://staticfs1.9kacha.com/image/0bc7a021957e571a052f9456dbba913e/thumb",
"wine_url":"http://th5.9kacha.com/index.php/Wine/detail?source=3d43436c-8331-11e7-aa1a-5254004b0a40&wine_id=064921199&sign=633c46e496cb2caad497eb333e496925C910A7AFCCE0EA11C71E728F734BEA52&year=2008&user_id=&search_id=v4em1ye3-20375-25048700-1505753683&signVar=216544a0891602f31bbd5b9339fd71b53c1debd1"
}
],
"advert":[
],
"imageid":[
"064921199"
],
"year":"2008",
"grape":"",
}
}
四、错误码信息
错误号 |
错误描述 |
说明 |
1 |
网关认证配置错误 |
京东AI平台对接口认证参数配置问题,报给服务商解决 |
1 |
提交的数据不是jpg/gif/png文件 |
提交文件不是图片文件 |
1 |
图片必须在1KB和4MB之间 |
没有正确提交图片文件或图片大小不满足条件 |
1 |
获取搜索结果失败 |
请求处理正确,没有匹配到商品信息 |