API-referentie

Heartbeats

Endpoint GET, POST or HEAD /hb/:token

Een heartbeat-monitor geeft je een URL met een geheim token. Roep die aan als de job klaar is; de monitor gaat down als er geen ping binnenkomt binnen het interval plus de marge.

1Request

GET, POST of HEAD naar https://in.blipit.io/hb/<token>. Geen sleutel, geen body. Alleen de hash van het token wordt opgeslagen, de URL wordt één keer getoond bij het aanmaken en kan worden vervangen vanaf de pagina Uptime.

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

2Antwoorden

200 {ok: true}. 404 {error: 'no heartbeat with that URL'} bij een onbekend token. 429 na 60 onbekende URL's vanaf één adres in een minuut; een URL die eerder heeft gepingd blijft werken tijdens de blokkering.

Goed om te weten

  • Zet de ping na && zodat een mislukte job niet pingt.
  • Heartbeats worden één keer per minuut geëvalueerd en zijn niet aan een regio gebonden.

Kom je er niet uit? Mail support@blipit.io. Sleutels en de exacte DSN van elk project staan onder API-sleutels in app.blipit.io.