发送心跳 [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次心跳;
- 心跳模式超时发出提醒的要求和限制,与发送实时提醒时一样,比如公众号提醒依然会扣除当日额度,依然会有冷却时间等。