提交精选展示位申请 | 微信开放文档

# 提交精选展示位申请

# 接口说明

通过该接口提交精选展示位申请，审核通过后会展示在店铺主页。
配置链接和描述信息，向用户展示你精选的商品或内容。

# 接口调用请求说明

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

# 请求参数说明

参数	类型	是否必填	描述
banner	Objct(Banner)	是	精选展示位。具体参数内容可参考：结构体Banner

# 请求参数示例

{
  "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	number	错误码
errmsg	string	错误信息
apply_id	number	申请编号

# 返回参数示例

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

# 错误码

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

# 结构体

精选展示位

参数	类型	是否必填	描述
scale	number	是	当前生效的展示位的展示样式。枚举值可参考：枚举值BannerScale 1-小图模式；2-大图模式
banner	Array Object(BannerItem)	是	精选展示位。最多5个。具体参数内容可参考：结构体BannerItem

# BannerItem

精选展示位明细

参数	类型	是否必填	描述
type	number	是	展示位类型。枚举值可参考：枚举值BannerType 1-商品；3-视频号；4-公众号
banner.img_url	string	是	图片url。请务必使用接口上传图片（参数resp_type=1），并将返回的img_url填入此处，不接受其他任何格式的图片url。若url曾经做过转换（ url前缀为mmecimage.cn/p/），则可以直接提交。
banner.title	string	是	标题。当scale为1-小图模式时最多12字，为2-大图模式时最多40字。
banner.description	string	否	描述。当scale为2-大图模式时可设置，最多100个字。当scale为1-小图模式时不可设置。
product.product_id	number	否	商品id。可通过接口获取商品列表查询本店铺的商品id。
finder.finder_user_name	string	否	视频号ID。可参考获取参数finder_user_name查询视频号ID。
finder.feed_id	string	否	视频ID。视频号视频的唯一标识。可参考获取参数feed_id查询视频ID。
official_account.url	string	否	公众号文章链接。可参考获取参数official_account.url查询公众号文章链接

# 获取参数

# finder_user_name

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

# feed_id

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

# official_account.url

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