API de monitorización de uptime
Todo lo que haces en la app lo puedes hacer por la API REST: crear monitores desde tu pipeline de despliegue, llevar el uptime y los tiempos de respuesta a tus propios paneles, mantener sincronizadas las páginas de estado y los canales de alerta. JSON de entrada, JSON de salida, un único token Bearer. Los tokens de API se incluyen desde el plan Business.
Primeros pasos
URL base
https://app.centoculus.com/api/v1
Cada petición lleva dos cabeceras: Authorization: Bearer <token> y Accept: application/json. Las peticiones con cuerpo envían JSON con Content-Type: application/json.
- Crea un token en Mi cuenta → Tokens de API en la app web o en la app móvil y elige sus scopes.
- Copia el token enseguida; solo se muestra una vez.
- Llama a
GET /me. Funciona con cualquier token y te dice de quién es.
Tu primera llamada:
curl https://app.centoculus.com/api/v1/me \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json"
La respuesta es tu usuario con su rol, idioma y los espacios de trabajo a los que llega el token (abreviado):
{
"data": {
"id": 4821,
"name": "Mara Lindqvist",
"email": "mara@example.com",
"role": "customer_admin",
"role_label": "admin",
"locale": "en",
"timezone": "Europe/Stockholm",
"customers": [{"id": 1207, "name": "Example Ltd"}],
"default_customer_id": 1207
}
}
Tokens y scopes
Un token tiene un nombre, una caducidad opcional (hasta 730 días) y los scopes que puede usar. Elige solo los scopes que necesita una integración: un panel recibe monitors:read e incidents:read, un script de despliegue monitors:write. En los planes inferiores a Business la sección es visible pero aparece atenuada.
| Scope | Permite |
|---|---|
monitors:read | Listar y mostrar monitores, uptime, uptime diario, tiempos de respuesta, tipos de comprobación, ubicaciones y el resumen del panel |
monitors:write | Crear, actualizar, eliminar, pausar y reanudar monitores |
servers:read | Listar y mostrar servidores y sus métricas |
servers:write | Crear, actualizar, eliminar, pausar y reanudar servidores; nuevo comando de instalación del agente |
incidents:read | Listar y mostrar incidencias, resumen del panel |
status-pages:read | Listar y mostrar páginas de estado |
status-pages:write | Crear, actualizar y eliminar páginas de estado y sus avisos |
notifications:read | Listar y mostrar canales de notificación y tipos de canal |
notifications:write | Crear, actualizar y eliminar canales (correo, Telegram, webhook, push), enviar una prueba |
GET /me funciona con cualquier token. La facturación, el equipo, los tokens, la seguridad de la cuenta y las reparaciones no son accesibles con un token de API y responden 403, igual que una llamada sin el scope correspondiente.
Revoca un token en el mismo sitio; deja de funcionar al instante.
Convenciones
- Las respuestas son JSON. Un objeto individual llega bajo
data, una lista bajodataconlinksymeta. - Los monitores y los servidores se direccionan por UUID; las incidencias, las páginas de estado y los canales de notificación, por un id numérico.
- Las fechas y horas son ISO 8601 en UTC, por ejemplo
2026-11-15T08:30:00.000000Z. - Las listas se paginan con los parámetros de consulta
pageyper_page;metaincluyecurrent_page,last_page,per_pageytotal. Tamaños de página por defecto: monitores 15 (máx. 200), incidencias 25 (máx. 100), canales de notificación 50, servidores 100, páginas de estado 15. - Las cuentas con varios espacios de trabajo (partners y resellers) pasan
customer_idal crear algo y pueden filtrar las listas con él. Las cuentas de cliente lo omiten. - No hay una cuota general de peticiones. Algunos endpoints tienen límite de frecuencia, por ejemplo el reenvío de una confirmación por correo (10 por minuto); responden 429 con
Retry-After. No consultes con más frecuencia que tu intervalo de comprobación; para datos en vivo, usa un canal webhook.
Errores
Los errores son JSON con un message. Los errores de validación añaden errors con una lista de mensajes por campo.
| Estado | Significado |
|---|---|
401 | Token ausente, no válido, caducado o revocado. |
402 | La monitorización está en pausa porque se agotó el saldo prepago (clientes de resellers); se reanuda tras una recarga. |
403 | Al token le falta el scope, el endpoint está cerrado a los tokens de API, o tu plan no incluye la función. |
404 | No encontrado, o no está en tu espacio de trabajo. |
409 | Conflicto, por ejemplo confirmar una dirección de correo que ya está confirmada. |
422 | Falló la validación; consulta errors. Si se alcanza un límite del plan, upgrade indica la función que desbloquea un plan superior. |
429 | Demasiadas peticiones a un endpoint con límite de frecuencia; espera los segundos indicados en Retry-After. |
Un error de validación:
HTTP/1.1 422 Unprocessable Content
{
"message": "The target field is required. (and 1 more error)",
"errors": {
"target": ["The target field is required."],
"interval_seconds": ["The interval must be at least 60 seconds on your plan."]
}
}
Monitores
Un monitor es una comprobación: un sitio web, un certificado SSL, un ping, un puerto TCP, un registro DNS, un heartbeat de cron o la configuración de correo de un dominio. Tipos: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types te dice qué tipos, intervalos y ubicaciones incluye tu plan y los valores por defecto de cada tipo.
| Endpoint | Qué hace |
|---|---|
GET /monitors |
Listar; filtros status, search, ids (separados por comas), with_stats=1 añade el uptime y el último tiempo de respuesta |
POST /monitors |
Crear; las comprobaciones empiezan en segundo plano |
GET /monitors/{id} |
Un monitor con sus ubicaciones y su incidencia abierta |
PATCH /monitors/{id} |
Actualizar; el tipo no se puede cambiar |
DELETE /monitors/{id} |
Eliminar (204) |
POST /monitors/{id}/pause |
Pausar; una incidencia abierta se cierra |
POST /monitors/{id}/resume |
Reanudar |
GET /check-types |
Tipos, valores por defecto y los límites de tu plan |
GET /locations |
Ubicaciones de comprobación activas (code, name, country) |
Campos al crear
| Campo | Descripción |
|---|---|
name |
Nombre visible, hasta 255 caracteres. Obligatorio. |
type |
Uno de los tipos anteriores. Obligatorio, no se puede cambiar después. |
target |
URL, nombre de host, dirección IP o dominio, según el tipo. Obligatorio salvo para heartbeat, que te da una URL de ping en su lugar. |
interval_seconds |
Intervalo de comprobación. El mínimo depende de tu plan; GET /check-types lo devuelve como limits.min_interval_seconds. |
locations |
Códigos de ubicación, por ejemplo ["eu", "sg"]. Cuántas puedes elegir depende de tu plan. |
primary_location |
Ubicación principal que confirma primero las caídas (Smart Verify). |
confirm_locations |
Cuántas ubicaciones deben ver el fallo antes de que se te avise (1–3). Configurable en los planes superiores. |
confirm_checks |
Cuántas comprobaciones fallidas seguidas confirman una caída (1–3). Configurable en los planes superiores. |
options |
Según el tipo. Para http: method (GET, HEAD, POST), expected_status (p. ej. 200-399 o 200,301), keyword con keyword_mode (present o absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Las opciones omitidas toman los valores por defecto de GET /check-types. |
Crear una comprobación de sitio web con una palabra clave:
curl -X POST https://app.centoculus.com/api/v1/monitors \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"locations": ["eu", "sg"],
"options": {"keyword": "Add to cart", "expected_status": "200-399"}
}'
La respuesta (201) es el monitor. provisioning.state pasa a synced en cuanto las ubicaciones lo han asumido, y status de pending a up tras la primera comprobación:
{
"data": {
"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"customer_id": 1207,
"name": "Shop",
"type": "http",
"target": "https://shop.example.com",
"interval_seconds": 60,
"options": {
"method": "GET",
"expected_status": "200-399",
"keyword": "Add to cart",
"keyword_mode": "present",
"timeout_seconds": 10,
"check_ssl": true,
"warn_days": 14,
"crit_days": 3,
"allow_self_signed": false
},
"location_codes": ["eu", "sg"],
"primary_location": "eu",
"smart_verify": true,
"confirm_locations": 1,
"confirm_checks": 1,
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"locations": [
{"code": "eu", "role": "primary", "name": "Europe", "status": "pending", "last_response_ms": null, "last_checked_at": null},
{"code": "sg", "role": "verify", "name": "Singapore", "status": "pending", "last_response_ms": null, "last_checked_at": null}
],
"open_incident": null,
"last_checked_at": null,
"status_changed_at": null,
"created_at": "2026-11-15T08:30:12.000000Z",
"updated_at": "2026-11-15T08:30:12.000000Z"
}
}
Valores de estado: pending, up, degraded, down, paused.
Pausar un monitor durante un despliegue y reanudarlo después:
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/pause \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
curl -X POST https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/resume \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
Uptime y tiempos de respuesta
El uptime se calcula a partir de las caídas (incidencias de gravedad major); los avisos, como un certificado a punto de caducar, no cuentan. Sin comprobar todavía significa null, no 100.
| Endpoint | Qué hace |
|---|---|
GET /monitors/{id}/uptime |
Uptime en porcentaje de las últimas 24 horas, 7 días y 30 días |
GET /monitors/{id}/daily-uptime |
Uptime por día natural (UTC), days 1–90, por defecto 30 |
GET /monitors/{id}/response-times |
Tiempo de respuesta y disponibilidad por ubicación, range 24h, 7d o 30d; puntos por hora, diarios para 30d |
Uptime:
curl https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/uptime \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{"data": {"24h": 100, "7d": 99.952, "30d": 99.987}}
Tiempos de respuesta (abreviado):
curl "https://app.centoculus.com/api/v1/monitors/6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44/response-times?range=24h" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"range": "24h",
"locations": {
"eu": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 212.4, "min_ms": 180, "max_ms": 402, "availability": 100},
{"time": "2026-11-15T08:00:00+00:00", "avg_ms": 230.1, "min_ms": 190, "max_ms": 388, "availability": 100}
],
"sg": [
{"time": "2026-11-15T07:00:00+00:00", "avg_ms": 512.8, "min_ms": 470, "max_ms": 790, "availability": 100}
]
}
}
}
Servidores
Un servidor es una máquina con el agente instalado, que informa de CPU, memoria, carga, discos, red y servicios. Al crear un servidor se devuelve el comando de instalación de un solo uso; ejecútalo en la máquina y el servidor aparece un momento después.
| Endpoint | Qué hace |
|---|---|
GET /servers |
Listar; filtro ids |
POST /servers |
Crear; la respuesta incluye install_command (Linux) e install_command_freebsd |
GET /servers/{id} |
Un servidor con inventario, última instantánea y umbrales |
PATCH /servers/{id} |
Renombrar, elegir los services vigilados, definir thresholds |
DELETE /servers/{id} |
Eliminar (204); el agente se retira de la monitorización |
POST /servers/{id}/pause |
Pausar; las incidencias abiertas se cierran |
POST /servers/{id}/resume |
Reanudar |
POST /servers/{id}/install-token |
Nuevo comando de instalación; rotate_key=true emite además una nueva clave de agente |
GET /servers/{id}/metrics |
Series para gráficos, range 24h, 7d o 30d: métrica → contexto → [unix time, avg, min, max] |
| Campo | Descripción |
|---|---|
name |
Nombre visible, hasta 100 caracteres. Obligatorio al crear. |
services |
Nombres de los servicios que el agente debe vigilar, por ejemplo ["nginx", "php8.4-fpm", "mariadb"]; hasta 200. El servidor informa de lo que ha encontrado en discovered.services. |
thresholds |
Umbrales de alerta: cpu_max (porcentaje), load_max_per_cpu, mem_min_pavail (porcentaje libre), fs_warn y fs_crit (porcentaje usado), inode_warn, agent_nodata_minutes, por punto de montaje en filesystems, y las expresiones regulares fs_types, fs_exclude, net_exclude. Los valores omitidos conservan los valores por defecto. |
Añadir un servidor y leer el comando de instalación de la respuesta:
curl -X POST https://app.centoculus.com/api/v1/servers \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name": "web-1"}'
{
"data": {
"id": "a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58",
"customer_id": 1207,
"name": "web-1",
"status": "pending",
"is_paused": false,
"provisioning": {"state": "pending"},
"services": [],
"install_token_expires_at": "2026-11-16T08:30:12.000000Z",
"install_command": "curl -fsSL https://app.centoculus.com/install/K7xQ2mVt9…Rd | sudo sh",
"install_command_freebsd": "fetch -qo - https://app.centoculus.com/install/K7xQ2mVt9…Rd | sh",
"created_at": "2026-11-15T08:30:12.000000Z"
}
}
Vigilar tres servicios y alertar al 80 por ciento de uso del disco:
curl -X PATCH https://app.centoculus.com/api/v1/servers/a3b9d6e2-5f10-4b8c-9e77-2c4d1a0f6b58 \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"services": ["nginx", "php8.4-fpm", "mariadb"],
"thresholds": {"fs_warn": 80, "fs_crit": 90}
}'
Incidencias
Una incidencia es una caída o un aviso de un monitor o de un servidor, desde started_at hasta resolved_at. Cada incidencia lleva su número de alerta, el mismo que muestra el correo de alerta.
| Endpoint | Qué hace |
|---|---|
GET /incidents |
Las más recientes primero; filtros monitor_id, status (open o closed), open=1 (caídas abiertas sin avisos), from y to (fechas) |
GET /incidents/{id} |
Una incidencia con su cronología: cuándo cayó y se recuperó cada ubicación, y la reparación que la resolvió |
Incidencias abiertas:
curl "https://app.centoculus.com/api/v1/incidents?status=open&per_page=10" \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": [
{
"id": 90412,
"monitor_id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44",
"monitor_name": "Shop",
"server_id": null,
"subject_type": "monitor",
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03.000000Z",
"resolved_at": null,
"duration_seconds": 241,
"alert_number": 101,
"alert_label": "Incident #101",
"affected_locations": ["eu", "sg"],
"failure_reason": "HTTP 502 instead of 200-399",
"fix": null
}
],
"links": {"first": "…?page=1", "last": "…?page=1", "prev": null, "next": null},
"meta": {"current_page": 1, "from": 1, "last_page": 1, "per_page": 10, "to": 1, "total": 1}
}
Campos útiles: subject_type (monitor o server), severity (major, warning, info), cause (por ejemplo unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations y, mientras está abierta, failure_reason con los últimos valores de la comprobación.
Páginas de estado
Una página de estado muestra monitores elegidos al público o a tu equipo, en nuestro dominio o en el tuyo. Los avisos anuncian trabajos de mantenimiento o explican una incidencia en curso.
| Endpoint | Qué hace |
|---|---|
GET /status-pages |
Listar |
POST /status-pages |
Crear |
GET /status-pages/{id} |
Una página con monitores, avisos y el estado de sus dominios |
PATCH /status-pages/{id} |
Actualizar; monitors reemplaza toda la lista |
DELETE /status-pages/{id} |
Eliminar (204) |
POST /status-pages/{id}/notices |
Añadir un aviso |
PUT /status-pages/{id}/notices/{notice} |
Actualizar un aviso |
DELETE /status-pages/{id}/notices/{notice} |
Quitar un aviso (204) |
| Campo | Descripción |
|---|---|
slug |
Parte de la dirección, 3–63 caracteres, letras minúsculas, dígitos y guiones; único. Obligatorio. |
title |
Título de la página. Obligatorio. |
description |
Texto breve bajo el título, hasta 2000 caracteres. |
logo_url |
Dirección HTTPS de un logotipo. |
custom_domain |
Dominio propio como status.example.com; requiere un plan con dominios de estado propios. |
is_public |
Pública (true) o solo para usuarios con sesión iniciada. |
monitors |
Lista ordenada de {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name y group son opcionales. |
Un aviso tiene kind (maintenance, info o incident), title, body (opcional, hasta 5000 caracteres), starts_at y un ends_at opcional.
Crear una página de estado pública con dos monitores:
curl -X POST https://app.centoculus.com/api/v1/status-pages \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"slug": "example-status",
"title": "Example status",
"is_public": true,
"monitors": [
{"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "display_name": "Online shop", "group": "Web"},
{"id": "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f", "group": "Web"}
]
}'
Anunciar una ventana de mantenimiento:
curl -X POST https://app.centoculus.com/api/v1/status-pages/318/notices \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"kind": "maintenance",
"title": "Database upgrade",
"body": "Checkout will be unavailable for about 15 minutes.",
"starts_at": "2026-11-20T01:00:00Z",
"ends_at": "2026-11-20T01:30:00Z"
}'
Canales de notificación
Un canal de notificación es una forma de llegar a alguien: una dirección de correo, un chat de Telegram, un webhook o los dispositivos push de un usuario. Un canal recibe las alertas de todos los monitores del espacio de trabajo, o solo las de los monitores indicados en monitor_ids. Qué tipos de canal incluye tu plan: GET /notification-channel-types.
| Endpoint | Qué hace |
|---|---|
GET /notification-channels |
Listar |
POST /notification-channels |
Crear; en un webhook, el secret de firma solo aparece en esta respuesta |
GET /notification-channels/{id} |
Un canal |
PATCH /notification-channels/{id} |
Actualizar; el tipo no se puede cambiar |
DELETE /notification-channels/{id} |
Eliminar (204) |
POST /notification-channels/{id}/test |
Enviar una notificación de prueba (202); una dirección de correo sin confirmar recibe de nuevo su enlace de confirmación |
GET /notification-channel-types |
Tipos de canal con available y paid |
| Campo | Descripción |
|---|---|
type |
email, telegram, webhook o push. Obligatorio, no se puede cambiar después. |
name |
Nombre visible. Obligatorio. |
config |
Según el tipo: {"email": "…"}, {"chat_id": "…"} o {"url": "https://…"}. Push no necesita configuración. Una dirección de correo nueva debe confirmarse por enlace antes de que se envíen alertas. |
monitor_ids |
UUID de los monitores a los que se aplica este canal; omítelo para todos los monitores. |
quiet_hours |
{"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: sin alertas en ese intervalo. |
escalation_delay_minutes |
Avisar a este canal solo cuando una caída dura tanto (0–1440). |
notify_recovery |
Enviar también el aviso de recuperación (true o false). |
is_active |
Activar o desactivar el canal sin eliminarlo. |
Crear un canal webhook para dos monitores y guardar el secret:
curl -X POST https://app.centoculus.com/api/v1/notification-channels \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus"},
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"notify_recovery": true
}'
{
"data": {
"id": 512,
"customer_id": 1207,
"type": "webhook",
"name": "Ops bot",
"config": {"url": "https://hooks.example.com/centoculus", "secret": "wq7Hc2…48 characters…Zp"},
"quiet_hours": null,
"escalation_delay_minutes": 0,
"notify_recovery": true,
"is_active": true,
"confirmed": true,
"monitor_ids": ["6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "9c2d4e6f-1a3b-4c5d-8e7f-6a5b4c3d2e1f"],
"created_at": "2026-11-15T08:41:55.000000Z",
"updated_at": "2026-11-15T08:41:55.000000Z"
}
}
Payload del webhook
Un canal webhook envía cada alerta por POST como JSON a tu URL, con un timeout de 10 segundos y sin redirecciones. El destino debe ser una dirección pública.
Cabeceras: X-Webhook-Timestamp (tiempo Unix), X-Webhook-Signature (sha256= seguido del HMAC-SHA256 de <timestamp>.<body> con el secret del canal como clave) y User-Agent: Uptime-Webhook/1.
event es down, recovered, paused o test. En una alerta de monitor el cuerpo incluye monitor (id, name, target) e incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); en una alerta de servidor, server (id, name) e incident con problem en lugar de las ubicaciones. subject es el titular de la alerta en el idioma del canal.
Cuerpo de una alerta de caída:
POST /your-endpoint HTTP/1.1
Content-Type: application/json
User-Agent: Uptime-Webhook/1
X-Webhook-Timestamp: 1794912843
X-Webhook-Signature: sha256=3f1b9c…e2a7
{
"event": "down",
"monitor": {"id": "6f1c2b1e-9d3a-4c7e-8b21-0f5a1d2e3c44", "name": "Shop", "target": "https://shop.example.com"},
"incident": {
"id": 90412,
"severity": "major",
"cause": "unreachable",
"started_at": "2026-11-15T09:14:03+00:00",
"resolved_at": null,
"duration_seconds": 0,
"affected_locations": ["eu", "sg"]
},
"subject": "DOWN: Shop"
}
Verifica la firma antes de fiarte del cuerpo: calcula el HMAC sobre el cuerpo en bruto exactamente como lo recibes y compáralo en tiempo constante. Rechaza las marcas de tiempo con más de unos pocos minutos.
Comprobar la firma en una shell:
expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"
Resumen del panel
GET /dashboard devuelve los recuentos que hay detrás de los mosaicos de la vista general: monitores por estado (los servidores cuentan con sus unidades del plan), servidores por estado y el número de incidencias abiertas. Cualquiera de los scopes monitors:read, servers:read o incidents:read lo abre.
curl https://app.centoculus.com/api/v1/dashboard \
-H "Authorization: Bearer $CENTOCULUS_TOKEN" -H "Accept: application/json"
{
"data": {
"monitors": {"pending": 0, "up": 46, "degraded": 1, "down": 1, "paused": 2},
"monitors_total": 50,
"servers": {"pending": 0, "up": 3, "degraded": 0, "down": 0, "paused": 0},
"open_incidents": 2
}
}
Preguntas frecuentes
¿Qué plan incluye la API?
Los tokens de API se incluyen desde el plan Business. En los planes más pequeños ves la sección en Mi cuenta atenuada, con un enlace para mejorar de plan. Todo lo demás en Centoculus funciona sin la API.
¿Puede un token hacer todo lo que hace mi cuenta?
No. Un token solo llega a las áreas para las que le has dado scopes, y nunca a la facturación, los miembros del equipo, otros tokens, la seguridad de la cuenta ni las reparaciones. Eso se queda en la app.
¿Hay un sandbox?
Para explorar, usa un token solo con scopes de lectura y crea monitores de prueba en el plan gratuito de una segunda cuenta. Los monitores que creas cuentan para tu plan igual que los creados en la app.
¿Cómo llevo las alertas a mi propio sistema?
Crea un canal webhook y verifica la firma de cada entrega. Cada caída, recuperación y pausa llega a tu URL en cuestión de segundos, con el monitor, la causa y las ubicaciones afectadas en JSON.
¿Cambia la API?
La versión va en la dirección (/api/v1). Se pueden añadir campos nuevos a las respuestas en cualquier momento; dentro de una versión no se eliminan ni se renombran campos. Lee lo que necesites e ignora el resto.
¿Listo para automatizar tu monitorización?
Los tokens de API se incluyen desde el plan Business. Compara los planes, o empieza gratis y mejora cuando tus scripts estén listos.