发送心跳 [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> <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> <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;">product</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>