喵提醒

喵提醒帮助与文档


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

页面列表

ITEM_HTML