产品文档

新品定制

新品定制

一、接口描述

1. 功能描述

新品定制(new product custom)API为用户提供针对冰箱品类的商品全新定制功能,输入具体品牌和冰箱品类,返回定制方案。

2. 接口使用

在获得使用权限后,您可使用已经封装好的SDK进行相应开发,整体流程详见调用方法

3. 接口数据要求:

  • brand:计划定制的产品品牌,可支持京东零售自营冰箱品牌,这里仅给出一个品牌演示
  • doorType:计划定制的产品冰箱品类,在这里为冰箱门的款式,可支持{单门、双门、三门、对开门、十字对开门、多门},这里仅给出两个款式演示

4. 能力说明:

输入为限定冰箱品类,其他品类的新品定制能力开发中。

二、请求说明

1. 接口地址 :

 https://aiapi.jdcloud.com/jdai/productCustom 

2. 请求方式:

https post aiapi.jdcloud.com/jdai/productCustom

3. 请求参数

(1)header请求参数

业务请求参数

名称 类型 必填 示例值 描述
Authorization string JDCLOUD2-HMAC-SHA256Credential=access... 签名
Content-Type String application/json 标准编码格式

(2)query请求参数

(3)body请求参数

名称 类型 必填 示例值 描述 范围
brand string 康佳 品牌 {康佳}
doorType string 双门 冰箱品类 {双门、多门}

4. 请求代码示例

建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见sdk的使用方法

三、返回说明

1、返回参数

(1)公共返回参数

名称 类型 示例值 描述
code string 1000 参见错误码-系统级错误码
charge boolean false 或 true false:不扣费, true:扣费
remain long 1305 按天计算剩余调用次数
msg string 查询成功 参见错误码-系统级错误码
result object {...} 查询结果

(2)业务返回参数

result参数信息 | 名称 | 类型 | 示例值 | 描述 | | ---- | ---- | ---- | ---- | | code | int | 0 | 参见下方错误码-业务错误码 | | message | string | ok | 提示信息 | | result | object | {...} | 返回定制结果,**design_dict** 表示定制方案, uv_score 表示对定制方案的UV转化得分预估 | | used_time | int | 100 | 整个请求花费的时间,单位为微秒,请求异常时无used_time |

2、返回示例

 {  "code": 0,  "message": "ok",  "result": {  "design_dict": {  "90度开门": "不具有",  "AC+净味": "不具有",  "DEO净味": "不具有",  "LTC蓝晶净味": "不具有",  "PST杀菌": "不具有",  "TABT除菌": "不具有",  "一体成型": "不具有",  "一体照明": "不具有",  "三循环": "不具有",  "价格": 1040,  "体积": "175L",  "假日功能": "具有",  "光合保鲜": "不具有",  "光触媒抗菌": "不具有",  "全冷气存鲜": "不具有",  "全开式抽屉": "不具有",  "全环绕气流": "不具有",  "净离子杀菌": "不具有",  "制冰": "不具有",  "制冷类型": "风冷",  "动力气流": "不具有",  "压缩机": "定频",  "双变频": "不具有",  "双循环": "不具有",  "发酵功能": "不具有",  "复古": "不具有",  "多路送风": "不具有",  "多重杀菌": "不具有",  "定制格局": "不具有",  "宽幅变温": "不具有",  "宽度": "60cm及以下",  "嵌入式": "不具有",  "干湿分储": "不具有",  "底部散热": "不具有",  "微冻保鲜": "不具有",  "微晶保鲜": "不具有",  "急速净味": "不具有",  "抗菌门封": "不具有",  "故障智能检测": "不具有",  "时尚吧台": "不具有",  "显示器": "不具有",  "智能WI-FI": "具有",  "智能保鲜": "不具有",  "智能变频": "不具有",  "智能杀菌": "不具有",  "水分子激活保鲜": "不具有",  "泡菜发酵": "不具有",  "涂层": "不具有",  "涡流动态杀菌": "不具有",  "深度": "51-55cm",  "温控方式": "机械控温",  "温湿精控": "不具有",  "独立变温室": "不具有",  "环保内胆": "具有",  "生物保鲜": "不具有",  "真空仓": "不具有",  "矢量变频": "不具有",  "立体蒸发器": "不具有",  "立体除菌": "不具有",  "简约风格": "具有",  "精细分储": "不具有",  "纤细边框": "不具有",  "纤薄设计": "不具有",  "纳米水离子除菌净味": "不具有",  "纳米除臭": "不具有",  "线性变频": "不具有",  "细胞级养鲜": "不具有",  "维他养鲜": "不具有",  "能效等级": "二级",  "脱氧触媒净味": "不具有",  "自动低温补偿": "不具有",  "自动悬停门": "不具有",  "臻材室": "不具有",  "蝶门美食窗": "不具有",  "负氧离子养鲜": "不具有",  "贴合橱柜": "不具有",  "速食盘设计": "不具有",  "金属酒架": "不具有",  "银离子除菌净味": "不具有",  "长效净味": "不具有",  "门中门": "不具有",  "门的款式": "双门",  "防串味": "不具有",  "防倾倒设计": "不具有",  "隐形门把手": "不具有",  "零度保鲜": "不具有",  "面板材质": "钢化玻璃",  "颜色": "银色",  "食物过期提醒": "不具有",  "饮水功能": "不具有",  "高度": "140.1-150cm"  },  "uv_score": 92.13  },  "used_time": 562 } 

3、业务错误码

业务错误码 message 说明
0 ok 成功
1004 "parameter error: {error reason}" 参数错误,并返回错误原因
40000 An unknown exception occurred. 接口调用失败,内部服务错误
更新时间:2020-04-28 21:14:32
文档反馈 docs feedback