# 上架商品到橱窗
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:addwindowproduct
通过该接口可将商品上架到橱窗。由于橱窗中自营商品的上下架状态会自动同步为商品在店铺中的状态,该api已无实际作用。
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/channels/ec/window/product/add?access_token=ACCESS_TOKEN
# 云调用
调用方法:channels.ec.window.product.add
出入参和 HTTPS 调用相同,调用方式可查看 云调用 说明文档
# 第三方调用
本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为:133、177
服务商获得其中之一权限集授权后,可通过使用 authorizer_access_token 代商家进行调用,具体可查看 第三方调用 说明文档。
# 2. 请求参数
# 查询参数 Query String parameters
| 参数名 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| access_token | string | 是 | ACCESS_TOKEN | 接口调用凭证,可使用 access_token、authorizer_access_token |
# 请求体 Request Payload
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| product_id | number | 是 | 橱窗商品ID |
| appid | string | 是 | 商品来源店铺的appid |
| is_hide_for_window | boolean | 否 | 是否需要在个人橱窗页隐藏 (默认为false) |
# 3. 返回参数
# 返回体 Response Payload
| 参数名 | 类型 | 示例 | 说明 |
|---|---|---|---|
| errcode | number | 0 | 错误码 |
| errmsg | string | ok | 错误信息 |
# 4. 注意事项
关于橱窗商品ID的说明
不支持带货中心来源的商品,其余商品的橱窗商品ID与商品来源处的平台内部商品ID相同,对应关系如下
| 商品来源 | 橱窗ID说明 |
|---|---|
| 视频号小店 | 视频号小店商品的 product_id 字段 |
| 交易组件 | 组件商品的 product_id 字 |
# 5. 代码示例
请求示例
{
"product_id": "100234056",
"appid": "wxee9f94a3360ad25f",
"is_hide_for_window": true
}
返回示例
{
"errcode": 0,
"errmsg": "ok"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码;调用接口遇到报错,可使用官方提供的 API 诊断工具 辅助定位和分析问题。
| 错误码 | 错误描述 | 解决方案 |
|---|---|---|
| 48001 | 接口权限未开启,需前往视频号助手- 开放能力-开放场景 打开开关 | |
| 10022001 | 验证视频号身份失败, 请检查是否使用视频号橱窗ID请求 | |
| 10022002 | 因违规行为, 橱窗被禁止使用, 请前往'带货中心->个人中心->带货权限'检查橱窗带货权限 | |
| 10022003 | 橱窗商品未找到 | |
| 10022004 | 商品异常,禁止添加到橱窗,请检查商品的banned_detail字段 | |
| 10022005 | 橱窗中的商品数超过1万,请减少商品数目后再重试 | |
| 10022007 | 不支持操作带货中心来源的商品 | |
| 10022008 | 请求的appid不属于该视频号的绑定店铺 |
# 7. 适用范围
本接口支持「视频号助手」账号类型调用。其他账号类型如无特殊说明,均不可调用。