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