新品定制
一、接口描述
1. 功能描述
新品定制(new product custom)API为用户提供针对冰箱品类的商品全新定制功能,输入具体品牌和冰箱品类,返回定制方案。
2. 能力说明:
输入为限定冰箱品类,其他品类的新品定制能力开发中。
3. 接口数据要求:
- brand:计划定制的产品品牌,可支持京东零售自营冰箱品牌,这里仅给出一个品牌演示
- doorType:计划定制的产品冰箱品类,在这里为冰箱门的款式,可支持{单门、双门、三门、对开门、十字对开门、多门},这里仅给出两个款式演示
4. 接口使用:
使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/productCustom
2. 请求方式:
POST
3. 请求参数
(1)query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 您的appkey,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(sectetkey+timestamp) |
(2)header请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | 表示请求JSON格式的文本信息 |
(3)body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 | 范围 |
---|---|---|---|---|---|
brand | string | 是 | 康佳 | 品牌 | {康佳} |
doorType | string | 是 | 双门 | 冰箱品类 | {双门、多门} |
4、请求代码示例
建议您使用我们提供的SDK进行调用,SDK获取及调用方式详见本页一接口描述中的4接口使用
三、返回说明
1、返回参数
(1)公共返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | string | 0 | 参见下方错误码-系统级错误码 |
charge | boolean | false 或 true | false:不扣费, true:扣费 |
remainTimes | long | 1305 | 剩余调用次数;免费api:每天剩余调用次数;收费api:剩余次数;无限制时为-1 |
remainSeconds | long | 123213 | 剩余调用时间(s);免费api:-1;收费api:剩余调用时间;无限制时为-1 |
msg | string | 查询成功 | 参见下方错误码-系统级错误码数 |
result | object | {...} | 查询结果 |
(2)业务返回参数
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码 | message | 说明 |
---|---|---|
0 | ok | 成功 |
1004 | "parameter error: {error reason}" | 参数错误,并返回错误原因 |
40000 | An unknown exception occurred. | 接口调用失败,内部服务错误 |