【独代】- 批量发送模板消息
<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 支付宝:zfb</td>
</tr>
<tr>
<td style="text-align: left;">mark </td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td><span style="color:red">请求唯一标识</span>,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,多个用户时用英文逗号连接,如1_10,2_10</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字符串,<span style="color:red">参考平台模板内容格式</span>,如微信:<code>{&quot;key1&quot;:{&quot;value&quot;:any}, &quot;key2&quot;:{&quot;value&quot;:any}}</code>, 头条:<code>{&quot;版本号&quot;: &quot;v1.0&quot;,&quot;版本描述&quot;: &quot;新版本发布了&quot;}</code>,支付宝:<code>{&quot;keyword1&quot;: {&quot;value&quot;:&quot;12:00&quot;},&quot;keyword2&quot;:{&quot;value&quot;:&quot;20180808&quot;},&quot;keyword3&quot;:{&quot;value&quot;:&quot;支付宝&quot;}}</code></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>// 成功
{
&quot;code&quot;: 1,
&quot;msg&quot;: &quot;success&quot;,
&quot;data&quot;: []
}
// 异常
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;param error&quot;} // 参数错误,缺少请求参数
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;check sign fail&quot;} // 签名错误
{&quot;code&quot;: -1, &quot;msg&quot;: &quot;uid数量超过限制&quot;} // 角色不存在
</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>