乐玩


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

<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>&lt;span style=&quot;color:red&quot;&gt;请求唯一标识&lt;/span&gt;,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字符串,&lt;span style=&quot;color:red&quot;&gt;参考平台模板内容格式&lt;/span&gt;,如微信:<code>{&amp;quot;key1&amp;quot;:{&amp;quot;value&amp;quot;:any}, &amp;quot;key2&amp;quot;:{&amp;quot;value&amp;quot;:any}}</code>, 头条:<code>{&amp;quot;版本号&amp;quot;: &amp;quot;v1.0&amp;quot;,&amp;quot;版本描述&amp;quot;: &amp;quot;新版本发布了&amp;quot;}</code>,支付宝:<code>{&amp;quot;keyword1&amp;quot;: {&amp;quot;value&amp;quot;:&amp;quot;12:00&amp;quot;},&amp;quot;keyword2&amp;quot;:{&amp;quot;value&amp;quot;:&amp;quot;20180808&amp;quot;},&amp;quot;keyword3&amp;quot;:{&amp;quot;value&amp;quot;:&amp;quot;支付宝&amp;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>// 成功 { &amp;quot;code&amp;quot;: 1, &amp;quot;msg&amp;quot;: &amp;quot;success&amp;quot;, &amp;quot;data&amp;quot;: [] } // 异常 {&amp;quot;code&amp;quot;: -1, &amp;quot;msg&amp;quot;: &amp;quot;param error&amp;quot;} // 参数错误,缺少请求参数 {&amp;quot;code&amp;quot;: -1, &amp;quot;msg&amp;quot;: &amp;quot;check sign fail&amp;quot;} // 签名错误 {&amp;quot;code&amp;quot;: -1, &amp;quot;msg&amp;quot;: &amp;quot;uid数量超过限制&amp;quot;} // 角色不存在 </code></pre> <h5>签名方式</h5> <ul> <li>签名方式:sign = MD5(SignString); </li> <li> <p>签名串生成方式:</p> <ul> <li>所有参数除sign外,按key的字典序排序,以key=value的格式拼接字符串,并以&amp;连接组成签名串,最后拼接服务端秘钥,例子见下:</li> <li> <p>秘钥:SERVER_KEY</p> </li> <li> <p>SignString = &#039;data={&quot;a&quot;:&quot;bbb&quot;}&amp;game=tianxiaonline-weixin&amp;mark=111&amp;page=index?a=111&amp;templateId=KJZHUYSHAGKSaZJU&amp;timeStamp=1652000000&amp;uids=1000_21_0,1001_21_0SERVER_KEY&#039;;</p> </li> <li>sign = MD5(data={&quot;a&quot;:&quot;bbb&quot;}&amp;game=tianxiaonline-weixin&amp;mark=111&amp;page=index?a=111&amp;templateId=KJZHUYSHAGKSaZJU&amp;timeStamp=1652000000&amp;uids=1000_21_0,1001_21_0SERVER_KEY)</li> </ul> </li> </ul>

页面列表

ITEM_HTML