API 参考

心跳

Endpoint GET, POST or HEAD /hb/:token

心跳监控器会给你一个带秘密 token 的 URL。任务完成时调用它；在间隔加宽限期内没有收到 ping 时，监控器视为宕机。

1请求

以 GET、POST 或 HEAD 任意一种方式请求 https://in.blipit.io/hb/<token>。无需密钥，无需请求体。只存储 token 的哈希，URL 在创建时显示一次，可从可用性页面替换。

sh
0 2 * * * /usr/local/bin/backup.sh && curl -fsS https://in.blipit.io/hb/<token>

2响应

200 {ok: true}。404 {error: 'no heartbeat with that URL'} 表示未知 token。429 表示同一地址一分钟内请求了 60 个未知 URL；之前 ping 过的 URL 在封禁期间继续可用。

须知

  • 把 ping 放在 && 之后，这样失败的任务就不会 ping。
  • 心跳每分钟评估一次，不绑定区域。

遇到问题？发邮件至 support@blipit.io。每个项目的密钥和确切的 DSN 在 app.blipit.io 的“API 密钥”下。