接口说明

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

Bug & Tip

请求 body 的Content-Type限定为application/json。
对单个用户推送消息，频率限制为 1 次/秒。
订阅消息分为一次性订阅和长期订阅（内测中），详情参考订阅消息能力。

基本信息

名称	描述
HTTP URL	https://minigame.zijieapi.com/mgplatform/api/apps/subscribe_notification/developer/v1/notify
HTTP Method	POST
Scope	open.ttgame.mgplatform

请求参数

请求头

content-type必填String

示例：application/json

固定值"application/json"

Body展开全部子属性

access_token必填String

示例：08011218462b6b4b5054626e426e50685a7554643144644449413d3d

调用https://minigame.zijieapi.com/mgplatform/api/apps/v2/token生成的token

app_id必填String

小程序的 id

open_id必填String

接收消息目标用户的 open_id，参考code2session

tpl_id必填String

模板的 id，参考订阅消息能力

dataMap

用于填充模板的关键词数据

展开子属性

pageString

跳转的页面，可参考小程序订阅消息

page参数，一般小游戏场景下无需使用

请求示例
curl -X POST \
 -H "content-type: application/json" \
 -d '{"access_token":"080112********6b6c537666514d413d3d","app_id":"tt4*********65","tpl_id":"MSG*********5237304","open_id":"vziikC*******FR9","page":"","data":{"名次": 1, "奖励": "500钻石", "领取时间": "202x-0x-xx"}}' \
 https://minigame.zijieapi.com/mgplatform/api/apps/subscribe_notification/developer/v1/notify

响应参数

Body

err_noInt64

错误码

err_tipsString

错误信息

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_tips": ""
}

错误码

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

开发者文档

发送订阅消息

接口说明

Bug & Tip

基本信息

请求参数

响应参数

错误码

发送订阅消息在线调试

接口说明

Bug & Tip

基本信息

请求参数

响应参数

错误码

发送订阅消息