【独代】- 批量发送模板消息
[TOC]
1、【模板消息】接口功能说明
调用该接口发送模板消息,支持微信和头条平台,支持批量发送
- 批量发送模板消息功能
请求URL
请求方式
- POST
请求参数
参数名 | 必选 | 类型 | 说明 |
---|---|---|---|
game | 是 | string | 游戏标识 |
platform | 是 | string | 平台标识, 微信:weixin / 抖音:toutiao |
mark | 是 | string | 请求唯一标识,cp方需要保证每次调用唯一,相同的mark值会被忽略 |
uids | 是 | string | 乐玩平台uid,最多一次性支持1000个uid,多个用户时用英文逗号连接,如1000_21_0,1001_21_0 |
templateId | 是 | string | 消息模板ID |
data | 是 | string | 模板内容,json字符串,参考平台模板内容格式,如微信:{"key1":{ "value": any }, "key2": {"value": any } }, 头条:{"版本号": "v1.0","版本描述": "新版本发布了"} |
page | 否 | string | 点击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。 |
timeStamp | 是 | integer | 时间戳,单位为:s |
sign | 是 | string | 签名,签名方式见下说明 |
返回示例
// 成功
{
"code": 1,
"msg": "success",
"data": []
}
// 异常
{"code": -1, "msg": "param error"} // 参数错误,缺少请求参数
{"code": -1, "msg": "check sign fail"} // 签名错误
{"code": -1, "msg": "uid数量超过限制"} // 角色不存在
签名方式
- 签名方式:sign = MD5(SignString);
-
签名串生成方式:
- 所有参数除sign外,按key的字典序排序,以key=value的格式拼接字符串,并以&连接组成签名串,最后拼接服务端秘钥,例子见下:
-
秘钥:SERVER_KEY
-
SignString = 'data={"a":"bbb"}&game=tianxiaonline-weixin&mark=111&page=index?a=111&templateId=KJZHUYSHAGKSaZJU&timeStamp=1652000000&uids=1000_21_0,1001_21_0SERVER_KEY';
- sign = MD5(data={"a":"bbb"}&game=tianxiaonline-weixin&mark=111&page=index?a=111&templateId=KJZHUYSHAGKSaZJU&timeStamp=1652000000&uids=1000_21_0,1001_21_0SERVER_KEY)