文档中心 电商接口 查询spu详情

查询spu详情

1.功能说明

根据 spuCode 和清单 ID,查询 spu 详情

2.接口调用说明

请求URL

https://openapi.guanaitong.tech/commerce/product/spu/detail

正式环境和测试环境的域名请见通用协议

HTTPS请求方式

POST

输入参数说明

(1)公共参数

发送请求是必须传入公共参数,详见公共参数

(2)私有参数

参数名称 是否必须 参数类型 长度限制 描述
inventory_id Integer 清单ID,对接前给出,需关爱通先配置商城
spu_code String spu 编码
请求示例
POST /commerce/product/spu/detail HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
cache-control: no-cache

access_token=48b3b588d536ef9082223f8368a17140&sign=39c4b425ce9aaba0ff9ae2bc8fa82837b4c294d9
&spu_code=PC20041400000001&timestamp=1573784826&inventory_id=101
                    
返回参数说明
参数名称 描述
code 返回码。详见错误代码
msg 如果错误,返回错误信息。
data SpuDetail对象
SpuDetail对象
spu_code String类型,商品编码
spu_name String类型,商品名称
product_title String类型,商品标题
seller_id Long类型,商品所属的商家 ID
selling_point String类型,卖点
master_category_id Integer类型,一级类目ID
master_category_name String类型,一级类目名称
second_category_id Integer类型,二级类目ID
second_category_name String类型,二级类目名称
third_category_id Integer类型,三级类目ID
third_category_name String类型,三级类目名称
brand_id Integer类型,品牌 ID
brand_name String类型,品牌名称
pc_desc String类型,PC 端的商品描述
mobile_desc String类型,移动端的商品描述
property_list List<Property>类型,商品的属性
picture_list List<Picture>类型,商品的图片
sku_list List<Sku>类型,spu 下各个 sku 的描述
status Integer类型,商品的状态,0-正常,1-不足,2-售罄,3-下架,4-禁售,5-商品不存在,6-部分售罄
status_str String类型,商品状态的说明
supply_status Integer类型,供货状态,0-停止供货 1-供货中
inventory_id Integer类型,清单 ID
deliver_city String类型,发货城市
deliver_notice String类型,发货通知
Sku对象说明
sku_code String类型,商品编号
sku_name String类型,商品名称
sku_index Integer类型,该 sku 在 spu 下的排序
price BigDecimal类型,商品价格
stock Integer类型,商品库存
is_enable Integer类型,该 sku 是否启用,0-否,1-是
finance_audit_result Integer类型,该 sku 是否通过财务审批,0-否,1-是,只用启用并且通过了财务审批的商品才能下单购买
property_list List<Property>类型,商品的属性
picture_list List<Picture>类型,商品的图片
Property对象说明
property_name String类型,属性名称
property_value String类型,属性值
Picture对象说明
picture_type int类型,图片类型 1-商品主图 2-商品详情图
picture_size_type Integer类型,图片大小 1-小图 2-中图 3-大图
picture_url String类型,图片地址
picture_index double类型,图片显示顺序(按从小到大顺序显示)(都等于1的就是不用排序,根据接口返回顺序展示)
正确返回示例
{
    "code":0,
    "msg":"OK",
    "data":{
        "master_category_id":431,
        "mobile_desc":"",
        "spu_name":"特步",
        "third_category_id":433,
        "spu_code":"PC20041400000001",
        "supply_status":1,
        "status_str":"正常",
        "brand_name":"特步",
        "pc_desc":"",
        "brand_id":42,
        "property_list":[
            {
                "property_value":"蓝色",
                "property_name":"123"
            },
            {
                "property_value":"cpx_001",
                "property_name":"123"
            }
        ],
        "sku_list":[
            {
                "property_list":[
                    {
                        "property_value":"蓝色",
                        "property_name":"123"
                    }
                ],
                "is_enable":1,
                "price":110,
                "finance_audit_result":1,
                "picture_list":[
                    {
                        "picture_index":1,
                        "picture_type":3,
                        "picture_size_type":2,
                        "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/52b896e667ee0d7a32d9bf053978403a.jpg"
                    }
                ],
                "sku_name":"123:蓝色",
                "sku_index":1,
                "stock":2000,
                "sku_code":"KC20041400000001"
            },
            {
                "property_list":[
                    {
                        "property_value":"cpx_001",
                        "property_name":"123"
                    }
                ],
                "is_enable":1,
                "price":55,
                "finance_audit_result":1,
                "picture_list":[
                    {
                        "picture_index":1,
                        "picture_type":3,
                        "picture_size_type":2,
                        "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/46f6ac41f4302ca7be01fa9581a45634.jpg"
                    }
                ],
                "sku_name":"123:cpx_001",
                "sku_index":2,
                "stock":1997,
                "sku_code":"KC20041400000002"
            }
        ],
        "master_category_name":"名牌箱包",
        "second_category_id":432,
        "third_category_name":"包",
        "picture_list":[
            {
                "picture_index":1,
                "picture_type":1,
                "picture_size_type":3,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/617559cf2954033813c6e0a06dcd5f3a.jpeg"
            },
            {
                "picture_index":1,
                "picture_type":2,
                "picture_size_type":3,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/b803e0810915b8849f461e9702e950df.jpg"
            },
            {
                "picture_index":1,
                "picture_type":1,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/617559cf2954033813c6e0a06dcd5f3a.jpeg"
            },
            {
                "picture_index":1,
                "picture_type":2,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/eac96c5da01eb186630ea2bf7a70134b.jpg"
            },
            {
                "picture_index":1,
                "picture_type":3,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/52b896e667ee0d7a32d9bf053978403a.jpg"
            },
            {
                "picture_index":1,
                "picture_type":3,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/46f6ac41f4302ca7be01fa9581a45634.jpg"
            },
            {
                "picture_index":2,
                "picture_type":1,
                "picture_size_type":3,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/52b896e667ee0d7a32d9bf053978403a.jpg"
            },
            {
                "picture_index":2,
                "picture_type":1,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/46f6ac41f4302ca7be01fa9581a45634.jpg"
            },
            {
                "picture_index":3,
                "picture_type":1,
                "picture_size_type":3,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/46f6ac41f4302ca7be01fa9581a45634.jpg"
            },
            {
                "picture_index":3,
                "picture_type":1,
                "picture_size_type":2,
                "picture_url":"https://img1.guanaitong.com/grus-gfs/dev/gmall-seller-mgr/by-days/2020-04-14/52b896e667ee0d7a32d9bf053978403a.jpg"
            }
        ],
        "product_title":"特步椒盐虾一盘500g",
        "deliver_city":"上海市",
        "selling_point":"椒盐虾一盘500g,现炒",
        "seller_id":608,
        "second_category_name":"箱包",
        "status":0
    }
}
                    
错误返回示例
{"code":1000210002,"data":null,"msg":"sign check failed!"}