【独代】- 批量发送模板消息
<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>