酒标识别

一、接口描述

1. 功能描述

发送图片二进制数据,直接返回葡萄酒识别结果信息。

2. 能力说明

  1. 图片格式:jpg/jpeg、png
  2. 图片像素尺寸:最小 100 100 像素,最大 3000 3000 像素
  3. 图片文件大小:最小 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 广告信息。格式:[{},{}]。


  • wineinfo数组中单个元素的结构:
字段 类型 字段说明
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


  • grape_variety数组中单个元素的结构:
字段 类型 字段说明
name_ch string 葡萄品种中文名
name_en string 葡萄品种中英名。
web_url_ch string 葡萄品种介绍url。


  • grade数组中单个元素的结构:
字段 类型 字段说明
RP string 罗伯特•帕克《葡萄酒倡导家》。
WS string 《葡萄酒观察家》。
WE string 《葡萄酒爱好者》杂志。
DE string 《品醇客》(Decanter)葡萄酒杂志。


  • buyInfo数组中单个元素的结构:
字段 类型 字段说明
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链接。


  • advert数组中单个元素的结构:
字段 类型 字段说明
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 获取搜索结果失败 请求处理正确,没有匹配到商品信息
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""