SPU详情

接口描述

该接口可通过SPU ID查询该SPU下全部SPL，SPL ITEM，SPV，ITEM的信息。

URL

/ark/open_api/v1/spu/{spu_id}

URL Parameter

字段名称 类型 说明
spu_id String SPU ID

Method

GET

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

{
    "error_code": 0,
    "data": {
        "spvs": [
            {
                "spu_id": "58e5b5f5af0a672afacf4564",
                "pending_changes": null,
                "import_cost": 123,
                "net_weight": 25,
                "qty": 1,
                "spl_id": "58e5b5f5af0a672afacf4565",
                "id": "58e5b5f6af0a672afacf4568",
                "unit": "件",
                "barcode_type": "upc",
                "non_desc_variants": [],
                "state": 1,
                "usage": "test modified",
                "shelf_life": 270,
                "ingredient": "test modified",
                "status": 2,
                "customs_photos_urls": [],
                "barcode": "test01",
                "gross_weight": 45,
                "customs_photos": [
                    {
                        "path": "items/d84d018842bbff888a8a132fcf445769",
                        "link": "http://img.xiaohongshu.com/items/d84d018842bbff888a8a132fcf445769",
                        "name": "test01-1491486124643",
                        "extension": ".jpg"
                    }
                ],
                "manufacturer": "test modified",
                "customs_specification": "test modified",
                "country": "中国"
            }
        ],
        "items": [
            {
                "spu_id": "58e5b5f5af0a672afacf4564",
                "update_time": 1491459994,
                "ename": "GUCCI testupdatespu white",
                "name": "GUCCI古驰 testupdatespu white",
                "logistics": "auto",
                "skucode": "test01",
                "original_price": 699.0,
                "tax": 52.700000000000003,   
                "pre_tax_price": 200.0,   
                "price": 252.69999999999999,   
                "tax_rate": 0.26350000000000001,
                "barcode": "test01",
                "pending_changes": null,
                "available": true,
                "buyable": false,
                "spv_id": "58e5b5f6af0a672afacf4568",
                "state": 1,
                "create_time": 1491449335,
                "status": 2,
                "spl_id": "58e5b5f5af0a672afacf4565",
                "top_image": null,
                "id": "58e5b5f7af0a672afacf456a",
                "barcode_type": "upc",
                "stock":0,
                "is_frozen": false
            }
        ],
        "spls": [
            {
                "spu_id": "58e5b5f5af0a672afacf4564",
                "status": 2,
                "id": "58e5b5f5af0a672afacf4565",
                "state": 1,
                "variants": [
                    {
                        "ename": "Color",
                        "id": "56d84f9a805d891008705275",
                        "value": "white",
                        "name": "颜色"
                    }
                ],
                "pending_change": null
            }
        ],
        "spus": [
            {
                "pending_changes": null,
                "ename": "testupdatespu",
                "name": "testupdatespu",
                "short_name": "testupdatespu",
                "brand": {
                    "ename": "GUCCI",
                    "id": "52d0deb1b4c4d655316b7d4b",
                    "name": "古驰"
                },
                "brand_id": "52d0deb1b4c4d655316b7d4b",
                "category_id": "572dd173939e250d08ec59f2",
                "id": "58e5b5f5af0a672afacf4564",
                "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": "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 parameter

名称 类型 说明
pending_changes Array 待审核的更改信息
spus Array SPU模块信息
id String SPU ID
name String SPU中文名称
ename String SPU英文名称
brand_id String 品牌ID
short_name String 商品简称（不超过15个字符）
categories Array 分类列表，从一级分类到末级分类
spls Array SPL模块信息
id String SPV ID
variants Array SPL规格列表
id String 规格ID
value String 规格值
spl_items Array 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 常见问题中的答案
spvs Dict spv模块信息
id String SPV ID
barcode String 商品条形码，只能输入“字母 数字 / -”
barcode_type String 条码类型
non_desc_variants Array SPV规格, 无SPV规格可不填
id String SPV规格id
value String SPV规格值
net_weight Float 净重
gross_weight Float 毛重
country String 原产国
qty Int 件数，内含数量
unit String 单位
shelf_life Int 保质期(天)
import_cost Float 进口成本价(CNY)(可粗略估计)
manufacturer String 生产厂家(填写全称，中文／英文)
customs_specification String 规格型号(例如，液体：10ml，10ml/支 (等其他计量单位) ；固体：10g，10g/支 (等其他计量单位)；配饰/鞋子/服装：尺寸、尺码、颜色。)
ingredient String 材质或成分含量(例如，水、二氧化碳等；帆布、牛皮等)
usage String 用途(例如，护肤等；背包、双肩包、凉鞋等)
customs_photos_urls Array 商品图片（用于海关备案）
items Array item模块信息
id String ITEM ID
available Bool true为可选择上架，false为不可选择上架
buyable Bool true为可售卖，实际上架状态， false为不可售卖，实际下架状态
top_image String 天王图
create_time Int 商品创建时间
update_time Int 最后更新时间
original_price Float 商品原价
tax Float 税金
pre_tax_price Float 税前价,跨境税商家必填
price Float 税后价,非跨境税商家必填
tax_rate Float 税率
spu_id String SPU ID
spl_id String SPL ID
spv_id String SPV ID
id String ITEM ID，商品id
stock Int 库存
is_frozen Bool true为已冻结，false为未冻结
logistics String ITEM的物流模式

补充说明

  1. 请注意库存由于实时变化所以使用库存筛选条件不一定完全匹配。

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