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