礼包码下发


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

[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