新品定制

一、接口描述

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. 接口调用失败,内部服务错误
Copyright © JD AI Platform all right reserved,powered by GitbookFile Modify: 2021-05-21 22:10:38

results matching ""

    No results matching ""