获取商品详情

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

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

接口描述

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

接口地址

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

请求参数

参数名类型参数位置是否必填说明
mall_codeStringquerytrue商城编码。
commodity_codeStringuritrue商品唯一编码。
langStringquerytrue语种。

返回参数

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

result 说明

参数名类型说明
commodity_codeString商品唯一编码。
titleString商品标题。
descriptionString商品描述。
brandString商品品牌。
codeString商城编码。
pidString商品 PID。
first_category_codeString一级类目编码。
second_category_codeString二级类目编码。
third_category_codeString三级类目编码。
show_picturesList展示图片。
detail_picturesList详情图片。
videoString视频。
video_picString视频封面图。
sku_listListSKU 列表信息。
postage_typeInteger邮费类型。
  • 1:免邮费。
  • 2:固定邮费。
postage_feeDouble邮费。
install_typeInteger安装类型。
  • 1:无需安装。
  • 2:上门安装。
  • 3:安装自理。
install_feeDouble安装费。
is_jumpBoolean是否开启商品跳转。
  • true:开启。
  • false:未开启。
jump_linkString商品跳转链接。
publishBoolean是否发布。
  • true:发布。
  • false:未发布。
typeInteger商品类型。
  • 0:实体商品。
  • 5:虚拟商品。
showcase_codesList前台类目编码列表。

sku_list 说明

参数名类型说明
sku_codeStringSKU 唯一编码。
original_priceDouble原价。
sale_priceDouble售价。
inventoryInteger库存。
weightDouble重量。
external_codeString外部编码。
sku_attr_listListSKU 属性列表。
sku_pic_listListSKU 图片列表。
support_out_stock_buyBoolean是否支持零库存下单。
  • true:支持。
  • false:不支持。

sku_attr_list 说明

参数名类型说明
attr_codeString属性唯一编码。
attr_nameString属性名称。
attr_value_idLong属性值 ID。
attr_value_nameString属性值名称。

请求示例

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
}

错误码

参考 错误码

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