# 获取微信红包封面

调试工具

接口应在服务器端调用,详细说明参见服务端API

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载),wx-server-sdk >= 0.4.0

# 接口说明

# 接口英文名

getRedPacketCoverUrl

# 功能描述

本接口用于获得指定用户可以领取的红包封面链接。获取参数ctoken参考微信红包封面开放平台

# 调用方式

# HTTPS 调用


POST https://api.weixin.qq.com/redpacketcover/wxapp/cover_url/get_by_token?access_token=ACCESS_TOKEN 

# 云调用

  • 出入参和HTTPS调用相同,调用方式可查看云调用说明文档

  • 接口方法为: openapi.redpacketcover.getAuthenticationUrl

# 第三方调用

  • 调用方式以及出入参和HTTPS相同,仅是调用的token不同

  • 该接口所属的权限集id为:112

  • 服务商获得其中之一权限集授权后,可通过使用authorizer_access_token代商家进行调用

# 请求参数

属性 类型 必填 说明
access_token string 接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
openid string 可领取用户的openid
ctoken string 在红包封面平台获取发放ctoken(需要指定可以发放的appid)

# 返回参数

属性 类型说明
errcode number 错误码
errmsg string 错误描述
data object 指定用户可以领取的链接(带鉴权的链接)
属性 类型 说明
url string 指定用户可以领取的链接(带鉴权的链接)

# 调用示例

示例说明: HTTPS请求示例

# 请求数据示例


{
      "openid":"xxxxxxxxxxmTo5lAUQxxxxxxxxxx",
      "ctoken":"xxxxxqpHPu1xxxxx"
  } 

# 返回数据示例


{
  "data" : {
      "url" : "https://xxx.xxx.xxx.xxx/xxx"
  },
  "errcode" : 0,
  "errmsg" : "success"
} 

# 错误码

错误码 错误码取值 解决方案
-1 system error 系统繁忙,此时请开发者稍候再试
9600001 参数缺失 openid
9600002 参数缺失 ctoken
9600003 系统错误
9600004 ctoken 错误
9600005 openid 错误
9600006 小程序不在配置列表中
9600007 小程序与openid不对应