订阅消息推送

用户产生了订阅模板消息的行为后,可以通过这个接口发送模板消息给用户,功能参考订阅消息能力

请求地址

    POST https://developer.toutiao.com/api/apps/subscribe_notification/developer/v1/notify

请求参数

请求 Body

属性数据类型必填说明
access_tokenstring小程序 access_token,参考登录凭证检验
app_idstring小程序的 id
tpl_idstring模板的 id,参考订阅消息能力
open_idstring接收消息目标用户的 open_id,参考code2session
dataobject用于填充模板的关键词数据
pagestring跳转的页面

返回值

正确返回的 JSON 如下:

属性数据类型说明
err_nonumber错误码
err_tipsstring错误信息

errCode

当请求失败时,会返回非 0 的 err_no,错误信息会携带在 err_tips 中,错误码含义如下:

错误号描述
0成功
1000参数格式有误
1001参数内容有误
1008通知内容违规
1009推送消息能力被封禁
1010发送消息过于频繁
2000服务内部错误

请求示例

请求 body

{
  "access_token": "b13b4c7679150245dac2249aafd8aca8e9dceaff9e22cee05e1d30fb67e18916358d73c235fcaab9007ec0976ee40d26ee56a43c32398b9d6680105e5535cd1ef40a803d790668581************",
  "app_id": "31198cf00b********",
  "tpl_id": "MSG38489d04608c5f0fdeb565fc5114afff6410*******",
  "open_id": "36d4bd3c8****",
  "data": {
    "版本号": "v1.0",
    "版本描述": "新版本发布了"
  },
  "page": "pages/index?a=b"
}

返回示例

正常返回

{
  "err_no": 0,
  "err_tips": ""
}

错误返回

{
  "err_no": 1001,
  "err_tips": "app_id / open_id不合法"
}

Bug & Tip

  • 请求 body 的Content-Type限定为application/json
  • 对单个用户推送消息,频率限制为 1 次/秒。
  • 订阅消息分为一次性订阅和长期订阅,详情参考订阅消息能力
点击纠错
评价此篇文档