# 查询精选展示位
# 接口说明
通过该接口可查询当前生效的精选展示位和流程中的申请。
# 接口调用请求说明
POST https://api.weixin.qq.com/channels/ec/basics/homepage/banner/get?access_token=ACCESS_TOKEN
# 请求参数说明
无请求参数
# 返回参数说明
| 参数 | 类型 | 描述 |
|---|---|---|
| errcode | number | 错误码 |
| errmsg | string | 错误信息 |
| banner | Objct(Banner) | 当前生效的展示位。具体参数内容可参考：结构体Banner |
| apply | Objct(Apply) | 最近一次流程中的申请。不返回已生效或已撤销的申请。具体参数内容可参考：结构体Apply |
# 返回参数示例
{
"errcode": 0,
"errmsg": "ok",
"banner": {
"scale": 2,
"banner": [
{
"type": 1,
"product": {
"product_id": 123
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/abc",
"title": "测试商品展示位标题",
"description": "测试商品展示位描述"
}
},
{
"type": 3,
"finder": {
"finder_user_name": "sphabc",
"feed_id": "export/abc"
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/bcd",
"title": "测试视频号视频展示位标题",
"description": "测试视频号视频展示位描述"
}
},
{
"type": 4,
"official_account": {
"url": "http://mp.weixin.qq.com/abc"
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/cde",
"title": "测试公众号文章展示位标题",
"description": "测试公众号文章展示位描述"
}
}
]
},
"apply": {
"apply_id": 123,
"state": 2,
"scale": 2,
"banner": [
{
"audit_state" : 1,
"audit_desc" : "图片不合规",
"banner": {
"type": 1,
"product": {
"product_id": 456
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/xyz",
"title": "测试商品展示位标题",
"description": "测试商品展示位描述"
}
}
},
{
"audit_state" : 1,
"audit_desc" : "图片不合规",
"banner": {
"type": 4,
"official_account": {
"url": "http://mp.weixin.qq.com/xyz"
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/wxy",
"title": "测试公众号文章展示位标题",
"description": "测试公众号文章展示位描述"
}
}
},
{
"audit_state" : 1,
"audit_desc" : "图片不合规",
"banner": {
"type": 3,
"finder": {
"finder_user_name": "sphxyz",
"feed_id": "export/xyz"
},
"banner": {
"img_url": "https://store.mp.video.tencent-cloud.com/vwx",
"title": "测试视频号视频标题",
"description": "测试视频号视频描述"
}
}
}
]
}
}
# 错误码
| 错误码 | 错误描述 |
|---|---|
| 公共错误码 | - |
| 268555516 | 无权限，仅供微信小店使用。 |
| 268549675 | 既无生效中的精选展示位，也无流程中的申请。 |
# 结构体
# Banner
精选展示位
| 参数 | 类型 | 描述 |
|---|---|---|
| scale | number | 当前生效的展示位的展示样式。枚举值可参考：枚举值BannerScale 1-小图模式；2-大图模式 |
| banner | Array Object(BannerItem) | 精选展示位。具体参数内容可参考：结构体BannerItem |
# BannerItem
精选展示位明细
| 参数 | 类型 | 描述 |
|---|---|---|
| type | number | 展示位类型。枚举值可参考：枚举值BannerType 1-商品；3-视频号；4-公众号 |
| banner.img_url | string | 图片url |
| banner.title | string | 标题 |
| banner.description | string | 描述 |
| product.product_id | number | 商品id |
| finder.finder_user_name | string | 视频号ID |
| finder.feed_id | string | 视频号视频的唯一标识 |
| official_account.url | string | 公众号文章url |
# Apply
精选展示位申请
| 参数 | 类型 | 描述 |
|---|---|---|
| apply_id | number | 申请编号 |
| state | number | 申请状态。枚举值可参考：枚举值State 1-审核中；2-审核驳回 |
| scale | number | 展示位的展示样式。枚举值可参考：枚举值BannerScale 1-小图模式；2-大图模式 |
| banner | array | 精选展示位申请明细 |
| banner[].audit_state | number | 审核状态。具体参数内容可参考：枚举值ApplyAuditState 1-审核中；2-审核驳回 |
| banner[].audit_desc | string | 审核结果描述。audit_state为驳回时有值。 |
| banner[].banner | Objct(BannerItem) | 精选展示位。具体参数内容可参考：结构体BannerItem |
# 枚举值
# BannerScale
展示样式
| 枚举值 | 描述 |
|---|---|
| 1 | 小图模式 |
| 2 | 大图模式 |
# BannerType
展示位类型
| 枚举值 | 描述 |
|---|---|
| 1 | 商品 |
| 3 | 视频号 |
| 4 | 公众号 |
# State
申请状态
| 枚举值 | 描述 |
|---|---|
| 1 | 审核中 |
| 2 | 审核驳回 |
# ApplyAuditState
审核状态
| 枚举值 | 描述 |
|---|---|
| 1 | 审核中 |
| 2 | 审核驳回 |