API-Referenz

Heartbeats

Endpoint GET, POST or HEAD /hb/:token

Ein Heartbeat-Monitor gibt Ihnen eine URL mit einem geheimen Token. Rufen Sie sie auf, wenn der Job fertig ist; der Monitor geht offline, wenn innerhalb des Intervalls plus Toleranz kein Ping ankommt.

1Request

GET, POST oder HEAD an https://in.blipit.io/hb/<token>. Kein Schlüssel, kein Body. Nur der Hash des Tokens wird gespeichert, die URL wird einmal bei der Erstellung angezeigt und kann über die Uptime-Seite ersetzt werden.

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

2Antworten

200 {ok: true}. 404 {error: 'no heartbeat with that URL'} für ein unbekanntes Token. 429 nach 60 unbekannten URLs von einer Adresse in einer Minute; eine URL, die schon einmal gepingt hat, funktioniert während der Sperre weiter.

Gut zu wissen

  • Setzen Sie den Ping hinter &&, damit ein fehlgeschlagener Job nicht pingt.
  • Heartbeats werden einmal pro Minute ausgewertet und sind nicht regionsgebunden.

Kommen Sie nicht weiter? Schreiben Sie an support@blipit.io. Schlüssel und den genauen DSN jedes Projekts finden Sie unter API-Schlüssel in app.blipit.io.