Resumen de la API
Cronitorex expone dos APIs, cada una con su propia clave API:
| API | URL base | Prefijo de clave | Propósito |
|---|---|---|---|
| Ingest API | https://api.cronitorex.com | ck_ | Recibir eventos de supervisión (pings) de tus jobs y servicios |
| Management API | https://app.cronitorex.com/api/v1 | mk_ | 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:
| API | Límite | Al excederlo |
|---|---|---|
| Ingest API | 10 peticiones/segundo, ráfaga de 20 | 429 Too Many Requests |
| Management API | 60 peticiones/minuto por clave API | 429 + cabeceras X-RateLimit-Limit / X-RateLimit-Remaining |
Endpoints
Ingest API
| Método | Ruta | Descripción |
|---|---|---|
POST | /ping | Enviar un evento de supervisión, ver POST /ping |
GET | /ping/{monitor} | Enviar un evento mediante parámetros de consulta, ver GET /ping |
GET | /health | Comprobació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étodo | Ruta | Descripción |
|---|---|---|
GET | /api/v1/monitors | Listar manifiestos de monitores (filtrar con ?kind=) |
GET | /api/v1/monitors/{uuid} | Obtener un monitor específico |
POST | /api/v1/monitors | Crear 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
- Swagger UI: prueba ambas APIs en el navegador
- Colección de Postman: peticiones listas para usar en todos los endpoints