wx.addCard(Object object)
基础库 1.1.0 开始支持,低版本需做兼容处理。
批量添加卡券。只有通过 认证 的小程序或文化互动类目的小游戏才能使用。更多文档请参考 微信卡券接口文档。
参数
Object object
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
cardList | Array.<Object> | 是 | 需要添加的卡券列表 | |
success | function | 否 | 接口调用成功的回调函数 | |
fail | function | 否 | 接口调用失败的回调函数 | |
complete | function | 否 | 接口调用结束的回调函数(调用成功、失败都会执行) |
object.cardList 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
cardId | string | 是 | 卡券 ID | |
cardExt | string | 是 | 卡券的扩展参数。需将 CardExt 对象 JSON 序列化为字符串传入 |
object.success 回调函数
参数
Object res
属性 | 类型 | 说明 |
---|---|---|
cardList | Array.<Object> | 卡券添加结果列表 |
res.cardList 的结构
属性 | 类型 | 说明 |
---|---|---|
code | string | 加密 code,为用户领取到卡券的code加密后的字符串,解密请参照:code 解码接口 |
cardId | string | 用户领取到卡券的 ID |
cardExt | string | 卡券的扩展参数,结构请参考下文 |
isSuccess | boolean | 是否成功 |
cardExt 说明
cardExt 是卡券的扩展参数,其值是一个 JSON 字符串。
示例代码
wx.addCard({
cardList: [
{
cardId: '',
cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
}, {
cardId: '',
cardExt: '{"code": "", "openid": "", "timestamp": "", "signature":""}'
}
],
success (res) {
console.log(res.cardList) // 卡券添加结果
}
})