发送心跳 [VIP]
<p>[TOC]</p>
<h5>简要描述</h5>
<ul>
<li>给指定喵码发送心跳请求。</li>
<li>以一定的频率向心跳网址发送心跳（如每3分钟请求一次），心跳持续期间提醒不会发出；当心跳暂停发送，系统超过未收到指定喵码的心跳时，按最近一次心跳请求夹带的参数发出提醒。</li>
<li>一次心跳超时而发出提醒后，该心跳检查停止，提醒不会再发出，直到该心跳链接再次被访问时，再次激活心跳检查。</li>
<li>心跳提醒仅供VIP会员用户使用，使用前需要编辑目标提醒，并勾选<code>开启心跳模式</code>选项。</li>
</ul>
<h5>请求URL</h5>
<ul>
<li><code>http://keepalive.miaotixing.com/send</code></li>
</ul>
<h5>请求方式</h5>
<ul>
<li>GET </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>
<th style="text-align: left;">示例</th>
</tr>
</thead>
<tbody>
<tr>
<td style="text-align: left;">id</td>
<td style="text-align: left;">是</td>
<td style="text-align: left;">string</td>
<td>喵码。指定向哪个提醒单发出提醒，一个提醒单对应一个喵码。</td>
<td style="text-align: left;">tDS0Se9</td>
</tr>
<tr>
<td style="text-align: left;">text</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>动态内容。收到的提醒时，会在标题换行后显示该内容，默认为空。</td>
<td style="text-align: left;">程序故障，错误号404</td>
</tr>
<tr>
<td style="text-align: left;">ts</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">uint</td>
<td>请求时的10位数时间戳，单位：秒。传入该参数时，喵提醒将检查当前时间与时间戳相差值，如果相差超过60秒则拒绝请求。不传该参数时不做时间检查。</td>
<td style="text-align: left;">1615865402</td>
</tr>
<tr>
<td style="text-align: left;">templ</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>套用定制模板参数。传入该值时，喵提醒将检查定制模板与参数格式是否匹配，匹配成功后将用定制模板内容取代原提醒内容，详见《定制模板使用方法》。不传该参数时不使用定制模板。</td>
<td style="text-align: left;">prvPe94,10,调试,无响应</td>
</tr>
<tr>
<td style="text-align: left;">app</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>外发产品id。传入该值时，系统将标记本次提醒关联的外发产品，并享受外发产品服务。默认为无关联的外发产品。</td>
<td style="text-align: left;">p123456</td>
</tr>
<tr>
<td style="text-align: left;">option</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">string</td>
<td>附加选项参数，多个参数之间用逗号隔开。支持以下参数：<br /><code>nosms</code>暂屏蔽短信通知<br /><code>nophonecall</code>暂屏蔽语音电话通知<br /><code>noemail</code>暂屏蔽电子邮件通知</td>
<td style="text-align: left;">nosms,nophonecall</td>
</tr>
<tr>
<td style="text-align: left;">expires</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">uint</td>
<td>过期时长，单位：分钟。超过该时长仍没上传心跳则发出提醒，可选范围：1~30，默认为5。</td>
<td style="text-align: left;">5</td>
</tr>
<tr>
<td style="text-align: left;">channel</td>
<td style="text-align: left;">否</td>
<td style="text-align: left;">uint</td>
<td>心跳频道。不同频道记录独立的心跳，心跳停止时由同一个喵码接收提醒。可选范围0~99，即最多100个频道。默认为0。</td>
<td style="text-align: left;">0</td>
</tr>
</tbody>
</table>
<h5>返回示例</h5>
<p>任何情况均返回唯一的字符串：</p>
<pre><code>done</code></pre>
<h5>注意事项</h5>
<ul>
<li>使用频道区分心跳时，建议开启提醒缓冲池，以避免几个心跳同时发出提醒时丢失。</li>
<li>同一喵码同一频道（channel）一分钟内心跳发送不能超过10次，超过该频率会被服务器拒绝服务，推荐每3分钟发送1次心跳；</li>
<li>心跳模式超时发出提醒的要求和限制，与发送实时提醒时一样，比如公众号提醒依然会扣除当日额度，依然会有冷却时间等。</li>
</ul>