编辑更新SPL ITEM

接口描述

通过该接口更新SPL ITEM模块信息，请注意更新时请求body中的所有字段必填做替换资源操作。

URL

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

URL Parameter

Method

PUT

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

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

{
  "image_urls":[
                  "http://img.xiaohongshu.com/items/3135edc58855dcf047fc39161ee9f687@2o.jpg"
                  ],
  "desc":"test modified",
  "feature":"test modified",
  "attributes":[
                  {
                       "property_id": "58450b30805d89635938325e",
                       "value_id": "56d84f9a805d891008705666"
                  },
                  {
                       "property_id": "58450b30805d89635938325f",
                       "value": "modified"
                  }
              ],
  "faqs": [
              {
                   "question": "modified",
                   "answer": "modified"
              }
          ],
  "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

补充说明

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

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

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

4. 原来的使用指南和小贴士已作废，上传无效。

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

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

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

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

6. 属性分为销售属性和非销售属性，其中销售属性为规格（SPL规格和SPV规格）可通过【由末级分类获取规格】接口获取， 非销售属性为产品参数，可通过【由末级分类获取产品参数】接口获取。 属性值为小红书系统提供的一系列可选择的属性值，通过【由属性获取属性值】接口获取不同属性下可使用的属性值。

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

{
    "error_code": 0,
    "data": {
        "spvs": [],
        "items": [],
        "spls": [],
        "spus": [],
        "spl_items": [
            {
                "spu_id": "58e5b5f5af0a672afacf4564",
                "status": 2,
                "videos": null,
                "spl_id": "58e5b5f5af0a672afacf4565",
                "feature": "initial",
                "image_urls": [],
                "faqs": [
                    {
                        "answer": "answer",
                        "question": "question"
                    }
                ],
                "state": 1,
                "pending_changes": {
                    "status": 0,
                    "videos": null,
                    "feature": "test modified",
                    "faqs": [
                        {
                            "answer": "modified",
                            "question": "modified"
                        }
                    ],
                    "images": [
                        {
                            "name": null,
                            "extension": ".jpg",
                            "height": 1200,
                            "width": 900,
                            "link": "http://img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                            "path": "items/d84d018842bbff888a8a132fcf445769"
                        }
                    ],
                    "attributes": null,
                    "desc": "test modified"
                },
                "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": "58e5b5f5af0a672afacf4566",
                "desc": "initial"
            }
        ]
    },
    "error_msg": null,
    "success": true
}

Response parameters

补充说明

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