查询橱窗上团长商品详情

# 查询橱窗上团长商品详情

# 接口说明

可通过该接口查询橱窗上团长商品详情

启用新多级类目树提示：旧的类目树固定为三级类目结构，新的类目树为多级类目结构，过渡期间，新旧类目树兼容使用，请开发者尽快切换到新多级类目树。其中差异请参阅“新旧类目树差异”。此接口新增 cats_v2 字段支持新类目树，详见参数。

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/league/headsupplier/window/getdetail?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
appid	string	否	团长appid
finder_id	string	否	视频号finder_id，未填openfinderid时必填，后续废弃
openfinderid	string	是	视频号openfinderid
product_id	number(uint64)	是	团长商品ID，可从获取联盟商品推广列表接口中获取

# 请求参数示例

{
    "appid": "app1234",
    "finder_id": "sph1234",
    "product_id": 1234
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
product_detail	object Item	商品所有信息，结构体详情请参考Item

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "product_detail": {
        "appid": "test",
        "product_id": 12345,
        "product_info": {
            "title": "test_title",
            "sub_title": "",
            "head_imgs": [
                "https://test.com/0"
            ],
            "desc_info": {
                "imgs": [
                    "https://test.com/0"
                ],
                "desc": ""
            },
            "cats": [
                {
                    "cat_id": "1421"
                },
                {
                    "cat_id": "1443"
                },
                {
                    "cat_id": "1452"
                }
            ],
            "cats_v2": [
                {
                    "cat_id": "1421"
                },
                {
                    "cat_id": "1443"
                },
                {
                    "cat_id": "1452"
                },
                {
                    "cat_id": "1476"
                }
            ],
            "product_promotion_link": "v1=HAOHK025pGFF8tBx69zbwNpU473uiTNa5MOHrs_Hknqa_-Cjk9IbBHMHeKh5rSnIrQ"
        }
    }
}

# 错误码

错误码	错误描述
公共错误码	-
2	该商品已移除
3	该商品已永久删除
10024000	参数错误
10024001	不合法的finder_id
10024003	不合法的appid
10024009	不合法的product_id
10024010	橱窗操作失败
10024020	橱窗不存在该商品

# 结构体

# Item

商品所有信息

参数	类型	描述
appid	string(uint64)	所属小店appid
product_id	string(uint64)	商品id
product_info	object ProductInfo	商品内容，结构体详情请参考ProductInfo

# ProductInfo

商品内容

参数	类型	描述
title	string	标题
sub_title	string	副标题。如果添加时没录入，回包可能不包含该字段
head_imgs	array string	主图，多张，列表，最多9张，每张不超过2MB
desc_info	object DescInfo	商品详情信息，如商品详情图片，商品详情文字，结构体详情请参考DescInfo
cats	Array <object CatInfo>	类目信息，结构体详情请参考CatInfo
cats_v2	Array <object CatInfo>	新类目树--类目信息，结构体详情请参考CatInfo
product_promotion_link	string	用于在小程序跳转小店场景添加商品时传递跟佣信息

# DescInfo

商品详情信息

参数	类型	描述
imgs	string array	商品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段
desc	string	商品详情文字。如果添加时没录入，回包可能不包含该字段

# CatInfo

类目信息

参数	类型	描述
cat_id	string(uint64)	类目id