阅读(2673)
赞(12)
QQ小游戏 订阅消息
2020-07-17 09:21:37 更新
sendSubscriptionMessage 本接口应在后端服务器调用,详细说明参见后端API。 发送订阅消息
请求地址
POST https://api.q.qq.com/api/json/subscribe/SendSubscriptionMessage?access_token=ACCESS_TOKEN
请求参数 | 属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|---|
access_token | string | 是 | 接口调用凭证 | ||
touser | string | 是 | 接收者(用户)的 openid | ||
template_id | string | 是 | 所需下发的订阅消息的模板id | ||
page | string | 否 | 点击订阅消息卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。 | ||
data | Object | 否 | 模板内容,要求字段数量和模板本身的字段数量一致。具体格式请参考示例。 | ||
emphasis_keyword | string | 否 | 模板需要放大的关键词,不填则默认无放大。 | ||
oac_appid | string | 否 | 若希望通过小程序绑定的公众号下发,则在该字段填入公众号的 appid |
返回值
Object
返回的 JSON 数据包
属性 | 类型 | 说明 |
---|---|---|
errcode | number | 错误码 |
errmsg | string | 错误信息 |
errcode 的合法值
值 | 说明 |
---|---|
40037 | template_id不正确 |
40014 | token过期 |
40015 | oac_appid不正确 |
40035 | 参数错误,请确认申请模块的参数和下发消息时传的参数是否一致 |
40036 | 内部错误,参照msg返回信息确认问题 |
40037 | template_id不正确,参照msg返回信息确认问题 |
41030 | 对同一用户推送请求太快 |
46001 | 用户未订阅 |
46002 | 当日超过推送限额 |
46003 | 用户拒收 |
46004 | 用户未关注公众号 |
46005 | 公众号未绑定小程序/小游戏 |
47001 | 小程序/小游戏被禁止发送消息 |
other | 联系对接同学 |
POST 数据格式:JSON
请求数据示例
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"data": {
"keyword1": {
"value": "339208499"
},
"keyword2": {
"value": "2019年5月05日 12:30"
},
"keyword3": {
"value": "腾讯大厦"
},
"keyword4": {
"value": "深圳市南山区高新科技园中区一路"
}
},
"emphasis_keyword": "keyword1.DATA"
}
返回数据示例
{
"errcode": 0,
"errmsg": "ok"
}