Ir al contenido
Centoculus

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.

  1. Crea un token en Mi cuenta → Tokens de API en la app web o en la app móvil y elige sus scopes.
  2. Copia el token enseguida; solo se muestra una vez.
  3. 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.

ScopePermite
monitors:readListar y mostrar monitores, uptime, uptime diario, tiempos de respuesta, tipos de comprobación, ubicaciones y el resumen del panel
monitors:writeCrear, actualizar, eliminar, pausar y reanudar monitores
servers:readListar y mostrar servidores y sus métricas
servers:writeCrear, actualizar, eliminar, pausar y reanudar servidores; nuevo comando de instalación del agente
incidents:readListar y mostrar incidencias, resumen del panel
status-pages:readListar y mostrar páginas de estado
status-pages:writeCrear, actualizar y eliminar páginas de estado y sus avisos
notifications:readListar y mostrar canales de notificación y tipos de canal
notifications:writeCrear, 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 bajo data con links y meta.
  • 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 page y per_page; meta incluye current_page, last_page, per_page y total. 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_id al 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.

EstadoSignificado
401Token ausente, no válido, caducado o revocado.
402La monitorización está en pausa porque se agotó el saldo prepago (clientes de resellers); se reanuda tras una recarga.
403Al token le falta el scope, el endpoint está cerrado a los tokens de API, o tu plan no incluye la función.
404No encontrado, o no está en tu espacio de trabajo.
409Conflicto, por ejemplo confirmar una dirección de correo que ya está confirmada.
422Falló la validación; consulta errors. Si se alcanza un límite del plan, upgrade indica la función que desbloquea un plan superior.
429Demasiadas 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.

EndpointQué 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

CampoDescripció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.

EndpointQué 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.

EndpointQué 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]
CampoDescripció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.

EndpointQué 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.

EndpointQué 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)
CampoDescripció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.

EndpointQué 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
CampoDescripció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.