阅读(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"
}