订阅接口

接口 URL

测试环境 https://test.creativity.qq.com:9311/sub/create

接口 GET 参数(必填)

appid:MOGS分配的appid

app_plat:平台类型， 1.微信 2.QQ 3.PC，目前仅支持微信，填 1

openid:用户openid

js_code: 自定义登陆态

接口字段说明 (POST 数据)

请求描述

参数	类型	是否必填	描述
subscription_list	SubscriptionInfo 数组	是	订阅列表

SubscriptionInfo 结构

字段名	类型	描述
template_id	string	订阅的模板ID
data	string	订阅的数据
page	string	跳转的页面
push_timestamp	string	订阅推送的时间戳
push_type	string	推送类型 1 表示定时订阅 2 表示非定时订阅

目标id 和 data 字段和规范，微信侧参考 https://developers.weixin.qq.com/minigame/dev/api-backend/open-api/subscribe-message/subscribeMessage.send.html

注：订阅功能支持两种订阅方式：定时订阅 和 不定时订阅。区别在于：定时订阅指所有玩家的订阅推送时间相同，不定时订阅是指每个玩家推送订阅的时间不等。

如果是对所有玩家来说提醒时间相同，例如提醒玩家活动开启时间等场景，建议采用定时订阅，MOGS 后台处理效率更高。

如果是每个玩家提醒时间不同，例如提醒玩家收益可领取等场景，则需要采用不定时订阅。

请求返回描述

参数	类型	描述
ret	int	返回值 （0-成功 其他-失败）
errmsg	string	失败原因

调用示例

curl -X POST -d '{"subscription_list": [{"template_id": "jStoY7zaVKzFgdOMvJEC7lJM0MnRI9YHxcDaS4y51w8","data": "{\"thing1\": {\"value\": \"hello world\"},\"time3\": {\"value\": \"14:00\"}}"}]}' 'https://test.creativity.qq.com:9311/sub/create?appid=10000&app_plat=1&openid=opvxI4y_cVJx2pxsFCQrJ4FZB5gk&js_code=xxx'