# 提交精选展示位申请

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

接口英文名：submitbannerapply

通过该接口提交精选展示位申请，审核通过后会展示在店铺主页。

配置链接和描述信息，向用户展示你精选的商品或内容。

# 1. 调用方式

# HTTPS 调用

POST https://api.weixin.qq.com/channels/ec/basics/homepage/banner/apply/submit?access_token=ACCESS_TOKEN

# 云调用

本接口不支持云调用。

# 第三方调用

本接口支持第三方平台代微信小店商家调用。第三方服务商调用模式介绍
该接口所属的权限集 id 为：129、131、192
服务商获得其中之一权限集授权后，可通过使用 authorizer_access_token 代微信小店商家进行调用，具体可查看第三方调用说明文档。

# 2. 请求参数

# 查询参数 `Query String Parameters`

参数名	类型	必填	示例	说明
access_token	string	是	ACCESS_TOKEN	接口调用凭证，可使用 access_token（微信小店商家）、authorizer_access_token（服务商代调用）

# 请求体 `Request Payload`

参数名	类型	必填	说明
banner	object	是	精选展示位。

# Body.banner `Object Payload`

精选展示位。

参数名	类型	必填	示例	说明
banner	objarray	是		精选展示位。最多 5 个，小图模式最少 3 个
scale	number	是	2	展示位的展示样式。1=小图模式，2=大图模式
title	string	否	示例标题	模块标题。最多 32 字

# Body.banner.banner(Array) `Object Payload`

精选展示位。最多 5 个，小图模式最少 3 个

参数名	类型	必填	示例	说明
banner	object	否		精选展示位
type	number	是	1	展示位类型。1=商品，3=视频号，4=公众号
product	object	否		-
finder	object	否		-
official_account	object	否		-

# Body.banner.banner(Array).banner `Object Payload`

精选展示位

参数名	类型	必填	示例	说明
img_url	string	是	https://store.mp.video.tencent-cloud.com/abc	图片 url。请务必使用上传图片接口上传图片（参数 resp_type=1），并将返回的 img_url 填入此处，不接受其他任何格式的图片 url。若 url 曾经做过转换（url 前缀为 mmecimage.cn/p/），则可以直接提交
title	string	是	测试商品精品展示位标题	标题。当 scale 为 1（小图模式）时最多 12 字，为 2（大图模式）时最多 40 字
description	string	否	测试商品精品展示位描述	描述。当 scale 为 2（大图模式）时可设置，最多 100 个字。当 scale 为 1（小图模式）时不可设置

# Body.banner.banner(Array).product `Object Payload`

参数名	类型	必填	示例	说明
product_id	number	否	123	商品 ID。可通过获取商品列表接口查询本店铺的商品 ID

# Body.banner.banner(Array).finder `Object Payload`

参数名	类型	必填	示例	说明
finder_user_name	string	否	sphabc	视频号 ID。可参考下文查询视频号 ID
feed_id	string	否	export/abc	视频 ID。视频号视频的唯一标识。可参考下文查询视频 ID

# Body.banner.banner(Array).official_account `Object Payload`

参数名	类型	必填	示例	说明
url	string	否	https://mp.weixin.qq.com/abc	公众号文章链接。可参考下文查询公众号文章链接

# 3. 返回参数

# 返回体 `Response Payload`

参数名	类型	示例	说明
errcode	number	0	错误码
errmsg	string	ok	错误信息
apply_id	number	123	申请编号

# 4. 注意事项

# 获取参数

# finder_user_name

代表视频号ID，获取视频号ID的需要登录视频号助手，在首页可以查看自己的视频号ID。

# feed_id

代表视频号视频的唯一标识，获取视频ID需要登录视频号助手，在「动态管理」模块可以复制自己发表的每个视频对应的视频ID。

# official_account.url

公众号文章链接，可在微信客户端打开公众号文章获取分享链接。

# 5. 代码示例

请求示例

{
  "banner": {
    "scale": 2,
    "banner": [
      {
        "type": 1,
        "product": {
          "product_id": 123
        },
        "banner": {
          "description": "测试商品精品展示位描述",
          "img_url": "https://store.mp.video.tencent-cloud.com/abc",
          "title": "测试商品精品展示位标题"
        }
      },
      {
        "type": 3,
        "finder": {
          "feed_id": "export/abc",
          "finder_user_name": "sphabc"
        },
        "banner": {
          "description": "测试视频号视频精品展示位描述",
          "img_url": "https://store.mp.video.tencent-cloud.com/abc",
          "title": "测试视频号视频精品展示位标题"
        }
      },
      {
        "type": 4,
        "official_account": {
          "url": "https://mp.weixin.qq.com/abc"
        },
        "banner": {
          "description": "测试公众号文章精品展示位描述",
          "img_url": "https://store.mp.video.tencent-cloud.com/abc",
          "title": "测试公众号文章精品展示位标题"
        }
      }
    ]
  }
}

返回示例

{
    "errcode": 0,
    "errmsg": "ok",
    "apply_id": 123
}

# 6. 错误码

以下是本接口的错误码列表，其他错误码可参考通用错误码；调用接口遇到报错，可使用官方提供的 API 诊断工具辅助定位和分析问题。

错误码	错误描述
268549841	已有流程中的申请。
268549927	参数错误。商品ID不能为空。
268549928	参数错误。banner类型有误。
268552545	参数错误。描述不能为空。
268552602	参数错误。标题长度有误。
268552603	参数错误。描述长度有误。
268552604	参数错误。描述必须为空。
268552621	参数错误。benner类型为视频号时，只能设置视频号相关参数。
268552622	参数错误。benner类型为公众号时，只能设置公众号相关参数。
268552764	参数错误。scale取值有误。
268552767	参数错误。标题不能为空。
268553052	参数错误。视频号ID不能为空。
268553053	参数错误。视频ID不能为空。
268553233	参数错误。benner类型为商品时，只能设置商品相关参数。
268553252	参数错误。图片链接不能为空。
268553714	参数错误。banner个数有误。
268555516	无权限，仅供微信小店使用。
268555602	参数错误。图片链接格式有误。
268555603	参数错误。图片链接格式有误。
268555694	参数错误。视频号ID与视频ID不匹配。
268555696	参数错误。商品ID有误。
268555698	参数错误。商品必须为上架状态。
268555705	参数错误。视频号ID有误。
268555706	参数错误。视频ID有误。
268555744	转换img_url时发生错误。
268555796	参数错误。公众号文章链接有误。
268555797	转换img_url时发生错误。

# 7. 适用范围

本接口在不同账号类型下的可调用情况：

微信小店	小店供货商
✔	✔

✔：该账号可调用此接口。
其他未明确声明的账号类型，如无特殊说明，均不可调用此接口。