创建SPL ITEM

接口描述

该接口可创建已存在的SPL下的SPL ITEM。

URL

/ark/open_api/v1/spl/{spl_id}/spl_item

URL Parameter

名称 类型 必填 说明
spl_id String Yes 已存在的SPL ID

Method

POST

Request Body (content-type:application/json;charset=utf8)

请务必按以下字段要求添加数据,以免系统报错。 

{
    "spl_item":{
        "image_urls":[
                        "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg"
                        ],
        "desc":"initial",
        "feature":"initial",
        "attributes":[
                        {
                             "property_id": "58450b30805d89635938325e",
                             "value_id": "56d84f9a805d891008705666"
                        },
                        {
                             "property_id": "58450b30805d89635938325f",
                             "value": "CHINA"
                        }
                    ],
        "faqs": [
                    {
                         "question": "question",
                         "answer": "answer"
                    }
                ],
        "user_guide":{
            "image_urls":[
                            "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg"
                            ]
        },
        "image_desc":{
            "image_urls":[
                            "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg"
                            ]
        }
    }
}

Request Body Parameters

名称 类型 说明
spl_item Dict SPL ITEM模块信息
image_urls Array 商品图片URL列表
feature String 商品特色 (8字真言，不超过八个字符)
desc String 商品描述
user_guide Dict 使用指南,支持上传图片url
image_urls Array 使用指南的图片url列表
image_desc Dict 图文详情
image_urls Array 图文详情的图片url列表
attributes Array 产品参数，补充信息
property_id String 产品参数id
value String 产品参数信息
faqs Array 常见问题
question String 常见问题中的问题
answer String 常见问题中的答案

补充说明

  1. 所有文描信息中请勿添加HTML标签，换行请用"\n"

  2. 使用产品参数和规格前请使用“由末级分类获取产品参数”和“由末级分类获取规格”接口得到需要填入的id。

  3. 其中attributes和faqs传入[]时会删掉已填信息。

  4. 请求中的image_urls字段为图片的url链接。

    • 商品图片 尺寸：800x800，750x1000；格式：JPG/PNG/JPEG；图片比例：1：1，3：4
    • 使用指南 尺寸：单个图片宽度为750px~1242px，高度≤1546px；

    • 商品详情 尺寸：单个图片宽度为750px~1242px，高度≤1546px；格式：JPG/PNG/JPEG；大小：每张图片容量应小于等于2M；

      注 请按照规则上传图片，如图片不符合要求，将不会有额外错误信息，调用接口后将无法在后台系统中看到对应图片，也无法展示在前端商详页。

  5. 属性分为销售属性和非销售属性，其中销售属性为规格（SPL规格和SPV规格）可通过【由末级分类获取规格】接口获取， 非销售属性为产品参数，可通过【由末级分类获取产品参数】接口获取。 通过【由属性获取属性值】接口获取不同属性下可使用的属性值。

Response 200 (application/json;charset=utf-8)

{
    "error_code": 0,
    "data": {
        "spvs": [],
        "items": [],
        "spls": [
            {
                "spu_id": "58e4a96caf0a672dcda6db07",
                "status": 2,
                "id": "58e4a96caf0a672dcda6db08",
                "state": 1,
                "variants": [
                    {
                        "ename": "Color",
                        "id": "56d84f9a805d891008705275",
                        "value": "white",
                        "name": "颜色"
                    }
                ],
                "pending_change": null
            }
        ],
        "spus": [
            {
                "pending_changes": null,
                "ename": "test1",
                "name": "test1",
                "short_name": "test1",
                "brand": {
                    "ename": "GUCCI",
                    "id": "52d0deb1b4c4d655316b7d4b",
                    "name": "古驰"
                },
                "brand_id": "52d0deb1b4c4d655316b7d4b",
                "category_id": "572dd173939e250d08ec59f2",
                "id": "58e4a96caf0a672dcda6db07",
                "categories": [
                    {
                        "ename": "Shoes",
                        "id": "52ce1c02b4c4d649b58b892f",
                        "name": "鞋子"
                    },
                    {
                        "ename": "Women's shoes",
                        "id": "56a6eecd8e7989cd56fcea7f",
                        "name": "女鞋"
                    },
                    {
                        "ename": "Women's high heels",
                        "id": "572dd173939e250d08ec59f2",
                        "name": "女士高跟鞋"
                    }
                ]
            }
        ],
        "spl_items": [
            {
                "spu_id": "58e4a96caf0a672dcda6db07",
                "status": 2,
                "videos": null,
                "spl_id": "58e4a96caf0a672dcda6db08",
                "feature": "initial",
                "image_urls": [
                    "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg"
                ],
                "faqs": [
                    {
                        "answer": "answer",
                        "question": "question"
                    }
                ],
                "state": 1,
                "pending_changes": {
                    "status": 0,
                    "videos": null,
                    "feature": null,
                    "faqs": null,
                    "images": [
                        {
                            "name": null,
                            "extension": ".jpg",
                            "height": 1200,
                            "width": 900,
                            "link": "http://img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                            "path": "items/d84d018842bbff888a8a132fcf445769"
                        }
                    ],
                    "attributes": null,
                    "desc": null
                },
                "user_guide": {
                    "images": [
                        {
                            "name": null,
                            "extension": ".jpg",
                            "height": 1200,
                            "width": 900,
                            "link": "//img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                            "path": "items/d84d018842bbff888a8a132fcf445769"
                        }
                    ],
                    "videos": []
                },
                "image_desc": {
                    "images": [
                        {
                            "name": null,
                            "extension": ".jpg",
                            "height": 1200,
                            "width": 900,
                            "link": "//img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                            "path": "items/d84d018842bbff888a8a132fcf445769"
                        }
                    ],
                    "image_urls": []
                },
                "images": null,
                "attributes": [
                    {
                        "ename": null,
                        "name": "材质",
                        "image": null,
                        "value": "TEST MATERIAL",
                        "image_url": null,
                        "property_id": "58450b30805d89635938325e"
                    },
                    {
                        "ename": null,
                        "name": "产地",
                        "image": null,
                        "value": "CHINA",
                        "image_url": null,
                        "property_id": "58450b30805d89635938325f"
                    }
                ],
                "id": "58e4a96caf0a672dcda6db09",
                "desc": "initial"
            }
        ]
    },
    "error_msg": null,
    "success": true
}

Response parameters

名称 类型 说明
pending_changes Array 待审核的更改信息
spus Array SPU模块信息
id String SPU ID
categories Array 分类列表，从一级分类到末级分类
spls Array SPL模块信息
id String SPV ID
spl_items Array SPL ITEM模块信息
id String SPL ID
spvs Array SPV模块信息
items Array ITEM模块信息
spu_id String SPU ID
spl_id String SPL ID
id String ITEM ID，商品id

补充说明

  1. state & status 具体状态码请参考商品状态码