Référence API

Heartbeats

Endpoint GET, POST or HEAD /hb/:token

Un moniteur heartbeat vous donne une URL avec un token secret. Appelez-la quand la tâche se termine ; le moniteur passe hors ligne quand aucun ping n'arrive dans l'intervalle plus le délai de grâce.

1Requête

GET, POST ou HEAD vers https://in.blipit.io/hb/<token>. Pas de clé, pas de corps. Seul le hachage du token est stocké, l'URL est affichée une fois à la création et peut être remplacée depuis la page Disponibilité.

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

2Réponses

200 {ok: true}. 404 {error: 'no heartbeat with that URL'} pour un token inconnu. 429 après 60 URL inconnues depuis une même adresse en une minute ; une URL qui a déjà pingué continue de fonctionner pendant le blocage.

Bon à savoir

  • Placez le ping après && pour qu'une tâche échouée ne pingue pas.
  • Les heartbeats sont évalués une fois par minute et ne sont pas liés à une région.

Bloqué ? Écrivez à support@blipit.io. Les clés et le DSN exact de chaque projet sont sous Clés API dans app.blipit.io.