创建商品
1. 描述
创建商品接口,支持单个或批量创建商品。商品以product_id为唯一标识,所有商品存在于商品库中。 图片及接口的通用信息说明,详见 服务概述
2. 接口地址
https://aiapi.jd.com/jdai/product_image_create_product
3. 请求方式
POST
4. 请求参数
(1) Query请求参数
公共请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
appkey | string | 是 | 80d2b762ecb86593f9668526920f46c | 应用key,可在买家中心控制台中获取 |
timestamp | long | 是 | 1541491668060 | 请求的时间戳,精确到毫秒,timestamp有效期5分钟 |
sign | string | 是 | 2e148773a0337a8f2200ba90d445f083 | 签名,根据规则MD5(secretkey+timestamp) |
(2) Header请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
Content-Type | string | 是 | application/json | 请求内容类型 |
(3) Body请求参数
业务请求参数
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
collection_name | string | 是 | 服饰商品库 | 商品库名称,最长50字符。如果不存在,会自动创建,每个用户最多拥有1个商品库 |
product_list | string | 是 | [...] | 创建的商品信息列表,一次最多200个 |
product_list参数说明
名称 | 类型 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
product_id | string | 是 | 104631367 | sku的唯一标识 |
product_name | string | 是 | 男士风衣 | sku的名字或者描述,支持256个字符,中英文下划线和数字 |
category | string | 是 | 服装 | 用户可指定【"服装"、"鞋靴"、"其他"】三个类目中的一个 |
5. 返回参数
(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) 业务返回参数
result参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
code | int | 0 | 参照概述-业务错误码 |
message | string | "SUCCESS" | 参照概述-业务错误信息 |
successful_list | array | [104631367, 104763573] | 创建成功的商品SKU |
failed_list | array | [...] | 创建失败的商品SKU及失败信息 |
failed_list参数信息
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
product_id | string | 104631735 | 创建失败的商品SKU |
message | string | EXISTING_PRODUCT | 失败信息 |
(3) 返回示例
{
"code": "10000",
"charge": false,
"remainTimes": 4998,
"remainSeconds": -1,
"msg": "查询成功",
"result": {
"code": 0,
"message": "SUCCESS",
"successful_list": [
"102340325"
],
"failed_list": [
{
"message": "EXISTING_PRODUCT",
"product_id": "102340326"
}
]
}
}