礼包码下发


【独代】- 批量发送模板消息

[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)

页面列表

ITEM_HTML