Referencia de la API

Heartbeats

Endpoint GET, POST or HEAD /hb/:token

Un monitor de heartbeat te da una URL con un token secreto. Llámala cuando termine el trabajo; el monitor se cae cuando no llega ningún ping dentro del intervalo más el margen.

1Petición

Cualquiera de GET, POST o HEAD a https://in.blipit.io/hb/<token>. Sin clave, sin cuerpo. Solo se guarda el hash del token; la URL se muestra una sola vez al crearla y puede reemplazarse desde la página de Disponibilidad.

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

2Respuestas

200 {ok: true}. 404 {error: 'no heartbeat with that URL'} para un token desconocido. 429 tras 60 URLs desconocidas desde una dirección en un minuto; una URL que ya ha hecho ping antes sigue funcionando durante el bloqueo.

Conviene saber

  • Pon el ping después de && para que un trabajo fallido no haga ping.
  • Los heartbeats se evalúan una vez por minuto y no están ligados a una región.

¿Atascado? Escribe a support@blipit.io. Las claves y el DSN exacto de cada proyecto están en Claves API en app.blipit.io.