# 提交精选展示位申请

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

接口英文名：submitbannerapply

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

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

# 1. 调用方式

# HTTPS 调用

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

# 云调用

本接口不支持云调用

# 第三方调用

本接口支持第三方平台代商家调用。
该接口所属的权限集 id 为：129、131
服务商获得其中之一权限集授权后，可通过使用 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	否	export/abc	视频号ID。可参考下文查询视频号ID。
feed_id	string	否	sphabc	视频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. 错误码

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

错误码	错误描述	解决方案
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. 适用范围

本接口支持「微信小店」账号类型调用。其他账号类型如无特殊说明，均不可调用。