微信小店
取消
中文
中文
EN
取消
  • 联盟带货机构

    • # 询橱窗上机构商品详情

    接口应在服务器端调用，不可在前端（小程序、网页、APP等）直接调用，具体可参考接口调用指南

    接口英文名：getwindowdetail

    可通过该接口查询橱窗上机构商品详情

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

    # 1. 调用方式

    # HTTPS 调用

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

    # 云调用

    • 调用方法：channels.ec.league.headsupplier.window.getdetail

    • 出入参和 HTTPS 调用相同，调用方式可查看 云调用 说明文档

    # 第三方调用

    • 本接口不支持第三方平台调用。

    # 2. 请求参数

    # 查询参数 Query String parameters

    参数名类型必填示例说明
    access_tokenstring是ACCESS_TOKEN接口调用凭证，可使用 access_token

    # 请求体 Request Payload

    参数名类型必填说明
    appidstring否机构appid
    finder_idstring否视频号finder_id，未填openfinderid时必填，后续废弃
    product_idnumber否商品id，和product_window_id二选一，可从查询橱窗上机构商品列表接口中获取
    openfinderidstring是视频号openfinderid，操作达人视频号橱窗时必填，和opentalentid二选一
    product_window_idnumber否橱窗商品ID，和product_id二选一【推荐使用】，可从查询橱窗上机构商品列表接口中获取 请求参数示例
    opentalentidstring是带货达人opentalentid，操作达人带货助手橱窗时必填，和openfinderid二选一

    # 3. 返回参数

    # 返回体 Response Payload

    参数名类型说明
    errcodenumber错误码
    errmsgstring错误信息
    product_detailobject商品所有信息

    # Res.product_detail Object Payload

    商品所有信息

    参数名类型说明
    appidstring所属小店appid
    product_idstring商品id
    product_infoobject商品内容

    # Res.product_detail.product_info Object Payload

    商品内容

    参数名类型说明
    titlestring标题
    sub_titlestring副标题。如果添加时没录入，回包可能不包含该字段
    head_imgsarray主图，多张，列表，最多9张，每张不超过2MB
    desc_infoobject商品详情信息，如商品详情图片，商品详情文字
    catsobjarray类目信息
    cats_v2objarray新类目树--类目信息
    product_promotion_linkstring用于在小程序跳转小店场景添加商品时传递跟佣信息

    # Res.product_detail.product_info.desc_info Object Payload

    商品详情信息，如商品详情图片，商品详情文字

    参数名类型说明
    imgsarray商品详情图片(最多20张)。如果添加时没录入，回包可能不包含该字段
    descstring商品详情文字。如果添加时没录入，回包可能不包含该字段

    # Res.product_detail.product_info.cats(Array) Object Payload

    类目信息

    参数名类型说明
    cat_idnumber类目id

    # Res.product_detail.product_info.cats_v2(Array) Object Payload

    新类目树--类目信息

    参数名类型说明
    cat_idnumber类目id

    # 4. 注意事项

    本接口无特殊注意事项

    # 5. 代码示例

    请求示例

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

    返回示例

    {
    "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"
        }
    }
}

    # 6. 错误码

    以下是本接口的错误码列表，其他错误码可参考 通用错误码

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

    # 7. 适用范围

    本接口暂未明确可调用账号类型，或在业务中根据调用传参自行确定是否可调用，请已实际调用情况为准。