老品升级
一、接口描述
1. 功能描述
老品升级(old product upgrade)API为用户提供产品智能升级方案,输入一款自营冰箱老品 sku_id ,返回针对这款产品的升级方案。
2. 能力说明:
可支持输入一款老品 sku_id 限定为京东自营冰箱品类,其它品类老品升级能力开发中
3. 接口数据要求:
- sku_id:京东零售在售自营冰箱商品编号,这里仅给出两个样例
4. 接口使用:
使用接口前,需要先完成API的下单购买,然后可使用已经封装好的SDK/参照接口鉴权规则进行相应开发,整体流程详见 接入流程
二、请求说明
1. 接口地址 :
https://aiapi.jd.com/jdai/productUpgrade
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请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 | 范围 |
---|---|---|---|---|---|
sku | string | 是 | 100003831465 | 商品sku_id | {100003831465, 6162905} |
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 | {...} | 具体升级结果,分为4个字段, before_change_dict 表示升级前老品的属性取值,changed_dict 表示升级方案改变了的属性,其中对每个改变的属性有一个列表,列表第一个元素为原来取值,第二个元素为升级后取值,before_change_uv_socre 表示升级前的UV转化得分,after_change_uv_socre 表示修改后的UV转化得分 |
used_time | int | 100 | 整个请求花费的时间,单位为微秒,请求异常时无used_time |
2、返回示例
{
"code": 0,
"message": "ok",
"result": {
"after_change_uv_socre": 93.46,
"before_change_dict": {
"90度开门": "不具有",
"AC+净味": "不具有",
"DEO净味": "不具有",
"LTC蓝晶净味": "不具有",
"PST杀菌": "不具有",
"TABT除菌": "不具有",
"一体成型": "具有",
"一体照明": "不具有",
"三循环": "不具有",
"价格": 1150,
"体积": "196L",
"假日功能": "不具有",
"光合保鲜": "不具有",
"光触媒抗菌": "不具有",
"全冷气存鲜": "不具有",
"全开式抽屉": "不具有",
"全环绕气流": "不具有",
"净离子杀菌": "不具有",
"制冰": "不具有",
"制冷类型": "混冷",
"动力气流": "不具有",
"压缩机": "定频",
"双变频": "不具有",
"双循环": "具有",
"发酵功能": "不具有",
"复古": "不具有",
"多路送风": "不具有",
"多重杀菌": "不具有",
"定制格局": "不具有",
"宽幅变温": "不具有",
"宽度": "61-65cm",
"嵌入式": "不具有",
"干湿分储": "不具有",
"底部散热": "不具有",
"微冻保鲜": "不具有",
"微晶保鲜": "不具有",
"急速净味": "不具有",
"抗菌门封": "不具有",
"故障智能检测": "不具有",
"时尚吧台": "不具有",
"显示器": "具有",
"智能WI-FI": "不具有",
"智能保鲜": "不具有",
"智能变频": "不具有",
"智能杀菌": "不具有",
"水分子激活保鲜": "不具有",
"泡菜发酵": "不具有",
"涂层": "不具有",
"涡流动态杀菌": "不具有",
"深度": "61-65cm",
"温控方式": "电脑控温",
"温湿精控": "不具有",
"独立变温室": "不具有",
"环保内胆": "不具有",
"生物保鲜": "不具有",
"真空仓": "不具有",
"矢量变频": "不具有",
"立体蒸发器": "不具有",
"立体除菌": "不具有",
"简约风格": "不具有",
"精细分储": "不具有",
"纤细边框": "不具有",
"纤薄设计": "不具有",
"纳米水离子除菌净味": "不具有",
"纳米除臭": "不具有",
"线性变频": "不具有",
"细胞级养鲜": "不具有",
"维他养鲜": "不具有",
"能效等级": "二级",
"脱氧触媒净味": "不具有",
"自动低温补偿": "不具有",
"自动悬停门": "不具有",
"臻材室": "不具有",
"蝶门美食窗": "不具有",
"负氧离子养鲜": "不具有",
"贴合橱柜": "不具有",
"速食盘设计": "不具有",
"金属酒架": "不具有",
"银离子除菌净味": "不具有",
"长效净味": "不具有",
"门中门": "不具有",
"门的款式": "三门",
"防串味": "具有",
"防倾倒设计": "不具有",
"隐形门把手": "不具有",
"零度保鲜": "不具有",
"面板材质": "彩钢",
"颜色": "金色",
"食物过期提醒": "不具有",
"饮水功能": "不具有",
"高度": "160.1-170cm"
},
"before_change_uv_socre": 87.85,
"changed_dict": {
"价格": [
1150,
900
],
"显示器": [
"具有",
"不具有"
],
"智能杀菌": [
"不具有",
"具有"
],
"温控方式": [
"电脑控温",
"机械控温"
]
}
},
"used_time": 537
}
四、错误码
1.系统级错误码
2.业务错误码
业务错误码 | message | 说明 |
---|---|---|
0 | ok | 成功 |
1004 | parameter error: {error :reason} | 参数错误,并返回错误原因 |
40000 | An unknown exception occurred. | 接口调用失败,内部服务错误 |