Skip to content
cronitorex.com

Resumen de la API

Cronitorex expone dos APIs, cada una con su propia clave API:

APIURL basePrefijo de clavePropósito
Ingest APIhttps://api.cronitorex.comck_Recibir eventos de supervisión (pings) de tus jobs y servicios
Management APIhttps://app.cronitorex.com/api/v1mk_Gestionar monitores como documentos manifest: listar, obtener, crear, actualizar

Autenticación

Ambas APIs se autentican con un token Bearer, pero cada una usa su propia clave:

Authorization: Bearer <api_key>
  • La clave de la Ingest API (ck_...) autentica solo pings.
  • La clave de la Management API (mk_...) autentica solo /api/v1.

Genera ambas claves en el panel bajo Configuración → Clave API. La Ingest API además acepta un parámetro de consulta ?api_key= para pings GET puntuales (ver GET /ping).

Tipo de contenido

Todos los cuerpos de petición deben ser application/json. Todas las respuestas son application/json.

Límites de tasa

Cada API tiene su propio límite:

APILímiteAl excederlo
Ingest API10 peticiones/segundo, ráfaga de 20429 Too Many Requests
Management API60 peticiones/minuto por clave API429 + cabeceras X-RateLimit-Limit / X-RateLimit-Remaining

Endpoints

Ingest API

MétodoRutaDescripción
POST/pingEnviar un evento de supervisión, ver POST /ping
GET/ping/{monitor}Enviar un evento mediante parámetros de consulta, ver GET /ping
GET/healthComprobación de salud de la API (no requiere autenticación)

Vocabulario de estados y tipos de evento: Tipos de evento y estados.

Management API

MétodoRutaDescripción
GET/api/v1/monitorsListar manifiestos de monitores (filtrar con ?kind=)
GET/api/v1/monitors/{uuid}Obtener un monitor específico
POST/api/v1/monitorsCrear un monitor a partir de un manifiesto
PUT/api/v1/monitors/{uuid}Actualizar un monitor (manifiesto completo)
DELETE/api/v1/monitors/{uuid}No soportado, devuelve 403; la eliminación es exclusiva del panel por diseño

Referencia completa con el formato del manifiesto: Management API.

Herramientas interactivas