获取联盟商品详情 | 微信开放文档

# 获取联盟商品详情

# 接口说明

可通过该接口获取联盟商品详情

# 接口调用请求说明

POST https://api.weixin.qq.com/channels/ec/league/item/get?access_token=ACCESS_TOKEN

# 请求参数说明

参数	类型	是否必填	描述
type	number	是	获取商品推广类别
product_id	string(uint64)	type为普通推广商品时必填	商品id
info_id	string(uint64)	type为特殊推广商品时必填	特殊推广商品计划id
need_relation	bool	否	是否获取特殊推广商品绑定的达人列表， type为特殊推广商品时有效
page_size	number	need_relation为真时必填	获取达人数不超过50
page_index	number	否	need_relation为真时有效，页面下标，下标从1开始，默认为1
need_total_num	bool	否	need_relation为真时有效，是否需要返回该计划绑定达人总数

# 请求参数示例

{
    "type": 2,
    "info_id": 123,
    "need_relation": true,
    "page_size": 1,
    "page_index": 1,
    "need_total_num": true
}

# 返回参数说明

参数	类型	描述
errcode	number	错误码
errmsg	string	错误信息
items	Object(Item)	推广商品信息,结构体详情请参考Item结构体

# 返回参数示例

{
    "errcode": 0,
    "errmsg": "ok",
    "item": {
        "product_id": "1000001",
        "type": 3,
        "status": 1,
        "ratio": 10,
        "exclusive_info": {
            "info_id": "123",
            "finder_ids": [
                "sphAAAA",
                "sphBBBB",
                "sphCCCC"
            ],
            "finder_num": 3,
            "finder_info_list": [
                {
                    "finder_id": "sphAAAA",
                    "begin_time": 1669867200,
                    "end_time": 1672459200
                },
                {
                    "finder_id": "sphBBBB",
                    "begin_time": 1669867200,
                    "end_time": 1672459200
                },
                {
                    "finder_id": "sphCCCC",
                    "begin_time": 1669867200,
                    "end_time": 1672459200
                }
            ]
        },
        "ext_info": {
            "is_sale_forbidden": false
        }
    }
}

# 错误码

错误码	错误描述
公共错误码	-
10023000	参数错误
10023001	不合法的finder_id
10023007	请先开通优选联盟
10023100	type类型错误
10023103	不存在该商品

# 结构体

# Item

推广商品信息

参数	类型	描述
product_id	string(uint64)	商品id
type	number	商品推广类别，枚举值详情请参考type
status	number	商品推广状态，枚举值详情请参考status
ratio	number	推广佣金[0, 90]%
exclusive_info	Object(ExclusiveInfo)	特殊推广信息，结构体详情请参考ExclusiveInfo
ext_info	Object(ExtInfo)	扩展信息，结构体详情请参考ExtInfo

# ExclusiveInfo

特殊推广信息

参数	类型	描述
info_id	string(uint64)	特殊推广商品计划id
finder_num	number	推广达人数量
finder_info_list	array(FinderExclusiveInfo)	推广达人视频号列表信息，结构体详情请参考FinderExclusiveInfo

# FinderExclusiveInfo

推广达人视频号信息

参数	类型	描述
begin_time	number	推广开始时间戳
end_time	number	推广结束时间戳
is_forerver	number	是否永久推广
finder_id	string	推广达人视频号id

# ExtInfo

扩展信息

参数	类型	描述
is_sale_forbidden	bool	是否类目禁售
is_banned	bool	是否被官方封禁

# 枚举值

# type

商品推广类别

枚举值	描述
1	普通推广商品
2	定向推广商品
3	专属推广商品

# status

商品推广状态

枚举值	描述
1	已上架推广
2	已下架推广
4	已删除
5	未达到准入标准
10	待生效