跳转到主要内容
心跳规则等作业每次跑完来打卡;过了周期加宽限还没打卡,或打卡报了失败,规则就触发。

打卡

地址在心跳规则第一次保存时给出,见创建规则。作业成功时请求它;失败时加上 ?status=fail,规则马上触发,不等周期。POST 的请求体开头(最多 1000 字)记成这次打卡带的话,会出现在事件的注解 heartbeat_message 里;请求体最大 64 KiB,超过时返回 413。打卡后规则立即判定一轮:报了失败就触发,报成功时开着的事件按恢复条件恢复。
status 只有 fail 算失败,别的值和不带都算成功。Token 不对、规则已删除或已重置时返回 404。

查看打卡状态

规则不是心跳规则,或还没有地址时返回 404。

重置打卡地址

换一个新地址,旧地址马上失效,打卡记录保留。返回 { "path": "...", "url": "..." },地址只在这时给出一次;没有设外部地址时 url 为 null。重置记进审计日志。规则不是心跳规则时返回 400。
最后修改于 2026年10月31日