获取商品详情

更新时间：2024-01-12 02:37:46下载pdf

本文介绍获取商品详情的 API。

接口描述

根据商品唯一编码，获取商品详情信息。

接口地址

GET: /v1.0/sellercenter/commodity/detail/{commodity_code}

请求参数

参数名	类型	参数位置	是否必填	说明
mall_code	String	query	true	商城编码。
commodity_code	String	uri	true	商品唯一编码。
lang	String	query	true	语种。

返回参数

参数名	类型	说明
result	CommodityDetailOpenApiVO	返回结果。

result 说明

参数名	类型	说明
commodity_code	String	商品唯一编码。
title	String	商品标题。
description	String	商品描述。
brand	String	商品品牌。
code	String	商城编码。
pid	String	商品 PID。
first_category_code	String	一级类目编码。
second_category_code	String	二级类目编码。
third_category_code	String	三级类目编码。
show_pictures	List	展示图片。
detail_pictures	List	详情图片。
video	String	视频。
video_pic	String	视频封面图。
sku_list	List	SKU 列表信息。
postage_type	Integer	邮费类型。 `1`：免邮费。 `2`：固定邮费。
postage_fee	Double	邮费。
install_type	Integer	安装类型。 `1`：无需安装。 `2`：上门安装。 `3`：安装自理。
install_fee	Double	安装费。
is_jump	Boolean	是否开启商品跳转。 `true`：开启。 `false`：未开启。
jump_link	String	商品跳转链接。
publish	Boolean	是否发布。 `true`：发布。 `false`：未发布。
type	Integer	商品类型。 `0`：实体商品。 `5`：虚拟商品。
showcase_codes	List	前台类目编码列表。

sku_list 说明

参数名	类型	说明
sku_code	String	SKU 唯一编码。
original_price	Double	原价。
sale_price	Double	售价。
inventory	Integer	库存。
weight	Double	重量。
external_code	String	外部编码。
sku_attr_list	List	SKU 属性列表。
sku_pic_list	List	SKU 图片列表。
support_out_stock_buy	Boolean	是否支持零库存下单。 `true`：支持。 `false`：不支持。

sku_attr_list 说明

参数名	类型	说明
attr_code	String	属性唯一编码。
attr_name	String	属性名称。
attr_value_id	Long	属性值 ID。
attr_value_name	String	属性值名称。

请求示例

GET: /v1.0/sellercenter/commodity/detail/CMaplyr4bzck***?mall_code=8h4tiureddm***&lang=zh

返回示例

{
    "tid": "7d18bcb5dd9211edacb5726e26805377",
    "result": {
        "multiple_options": true,
        "commodity_code": "CMaplyr4bzck***",
        "code": "define_code",
        "show_pictures": [
            "http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
        ],
        "description": "",
        "install_fee": 1,
        "pid": "",
        "title": "冰箱",
        "type": 0,
        "detail_pictures": [
            "http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
        ],
        "postage_fee": 100,
        "install_type": 2,
        "third_category_code": "131211",
        "showcase_codes": [
            "Cbgrc6mvk***"
        ],
        "first_category_code": "12",
        "sku_list": [
            {
                "original_price": 1,
                "support_out_stock_buy": false,
                "weight": 0,
                "sku_attr_list": [
                    {
                        "attr_code": "ATat2mzpe14***",
                        "attr_value_name": "棉",
                        "attr_name": "材料",
                        "attr_value_id": 52822311
                    }
                ],
                "inventory": 100,
                "sale_price": 2,
                "external_code": "",
                "sku_pic_list": [
                    "http://image-demo.oss-cn-hangzhou.aliyuncs.com/exa****.jpg"
                ],
                "sku_code": "SKcipzukv5m***"
            }
        ],
        "publish": true,
        "postage_type": 1,
        "second_category_code": "1312",
        "is_jump": false,
        "brand": ""
    },
    "t": 1681785675323,
    "success": true
}

错误码

参考错误码。

错误码	错误信息	描述
2000000	params error	参数错误

上一篇获取 SKU 支持关联的属性

下一篇获取商品支持关联的类目