Vai al contenuto
Centoculus

API di uptime monitoring

Tutto quello che fai nell’app puoi farlo anche con l’API REST: creare monitor dalla tua pipeline di deploy, portare uptime e tempi di risposta nelle tue dashboard, tenere sincronizzate status page e canali di avviso. JSON in ingresso, JSON in uscita, un solo token Bearer. I token API sono inclusi dal piano Business in su.

Primi passi

URL di base

https://app.centoculus.com/api/v1

Ogni richiesta porta due header: Authorization: Bearer <token> e Accept: application/json. Le richieste con body inviano JSON con Content-Type: application/json.

  1. Crea un token in Il mio account → Token API nell’app web o nell’app per il telefono e scegli i suoi scope.
  2. Copia subito il token: viene mostrato una sola volta.
  3. Chiama GET /me. Funziona con qualsiasi token e ti dice a chi appartiene.

La tua prima chiamata:

curl https://app.centoculus.com/api/v1/me \
  -H "Authorization: Bearer $CENTOCULUS_TOKEN" \
  -H "Accept: application/json"

La risposta è il tuo utente con ruolo, lingua e gli spazi di lavoro raggiunti dal token (abbreviata):

{
  "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
  }
}

Token e scope

Un token ha un nome, una scadenza facoltativa (fino a 730 giorni) e gli scope che può usare. Scegli solo gli scope di cui un’integrazione ha bisogno: una dashboard riceve monitors:read e incidents:read, uno script di deploy monitors:write. Nei piani inferiori a Business la sezione è visibile ma disattivata.

ScopeConsente
monitors:readElencare e mostrare monitor, uptime, uptime giornaliero, tempi di risposta, tipi di controllo, località, riepilogo della dashboard
monitors:writeCreare, aggiornare, eliminare, mettere in pausa e riprendere i monitor
servers:readElencare e mostrare i server e le loro metriche
servers:writeCreare, aggiornare, eliminare, mettere in pausa e riprendere i server; nuovo comando di installazione dell’agent
incidents:readElencare e mostrare gli incidenti, riepilogo della dashboard
status-pages:readElencare e mostrare le status page
status-pages:writeCreare, aggiornare ed eliminare le status page e i loro avvisi
notifications:readElencare e mostrare i canali di notifica e i tipi di canale
notifications:writeCreare, aggiornare ed eliminare i canali (e-mail, Telegram, webhook, push), inviare un test

GET /me funziona con qualsiasi token. Fatturazione, team, token, sicurezza dell’account e riparazioni non sono raggiungibili con un token API e rispondono 403, come anche una chiamata senza lo scope corrispondente.

Revoca un token nello stesso punto; smette di funzionare subito.

Convenzioni

  • Le risposte sono JSON. Un singolo oggetto arriva sotto data, una lista sotto data con links e meta.
  • Monitor e server si indirizzano con un UUID; incidenti, status page e canali di notifica con un id numerico.
  • Gli orari sono ISO 8601 in UTC, per esempio 2026-11-15T08:30:00.000000Z.
  • Le liste sono paginate con i parametri di query page e per_page; meta contiene current_page, last_page, per_page e total. Dimensioni di pagina predefinite: monitor 15 (max. 200), incidenti 25 (max. 100), canali di notifica 50, server 100, status page 15.
  • Gli account con più spazi di lavoro (partner e reseller) passano customer_id quando creano qualcosa e possono usarlo per filtrare le liste. Gli account cliente lo omettono.
  • Non c’è una quota generale di richieste. Alcuni endpoint sono limitati, per esempio il nuovo invio di una conferma e-mail (10 al minuto); rispondono 429 con Retry-After. Non interrogare più spesso del tuo intervallo di controllo; per i dati in tempo reale usa un canale webhook.

Errori

Gli errori sono JSON con un message. Gli errori di validazione aggiungono errors con una lista di messaggi per campo.

StatoSignificato
401Token mancante, non valido, scaduto o revocato.
402Il monitoraggio è in pausa perché il credito prepagato è esaurito (clienti dei reseller); riprende dopo una ricarica.
403Al token manca lo scope, l’endpoint è chiuso ai token API oppure il tuo piano non include la funzione.
404Non trovato, oppure non nel tuo spazio di lavoro.
409Conflitto, per esempio la conferma di un indirizzo e-mail già confermato.
422Validazione non riuscita; vedi errors. Quando si raggiunge il limite del piano, upgrade indica la funzione che un piano superiore sblocca.
429Troppe richieste a un endpoint limitato; attendi i secondi indicati da Retry-After.

Un errore di validazione:

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."]
  }
}

Monitor

Un monitor è un controllo: un sito web, un certificato SSL, un ping, una porta TCP, un record DNS, un heartbeat di cron o la configurazione di posta di un dominio. Tipi: http, ssl, ping, tcp, dns, heartbeat, maildns, mailflow. GET /check-types ti dice quali tipi, intervalli e località include il tuo piano e i valori predefiniti di ogni tipo.

EndpointCosa fa
GET /monitors Elenca; filtri status, search, ids (separati da virgole), with_stats=1 aggiunge uptime e ultimo tempo di risposta
POST /monitors Crea; i controlli partono in background
GET /monitors/{id} Un monitor con le sue località e l’incidente aperto
PATCH /monitors/{id} Aggiorna; il tipo non può cambiare
DELETE /monitors/{id} Elimina (204)
POST /monitors/{id}/pause Metti in pausa; un incidente aperto viene chiuso
POST /monitors/{id}/resume Riprendi
GET /check-types Tipi, valori predefiniti e limiti del tuo piano
GET /locations Località di controllo attive (code, name, country)

Campi alla creazione

CampoDescrizione
name Nome visualizzato, fino a 255 caratteri. Obbligatorio.
type Uno dei tipi indicati sopra. Obbligatorio, non modificabile in seguito.
target URL, nome host, indirizzo IP o dominio, a seconda del tipo. Obbligatorio tranne per heartbeat, che ti fornisce invece un URL di ping.
interval_seconds Intervallo di controllo. Il minimo dipende dal tuo piano; GET /check-types lo restituisce come limits.min_interval_seconds.
locations Codici delle località, per esempio ["eu", "sg"]. Quante puoi sceglierne dipende dal tuo piano.
primary_location Località principale che conferma per prima i disservizi (Smart Verify).
confirm_locations Quante località devono vedere il guasto prima che tu venga avvisato (1–3). Configurabile nei piani superiori.
confirm_checks Quanti controlli falliti di fila confermano un disservizio (1–3). Configurabile nei piani superiori.
options A seconda del tipo. Per http: method (GET, HEAD, POST), expected_status (ad es. 200-399 o 200,301), keyword con keyword_mode (present o absent), timeout_seconds, check_ssl, warn_days, crit_days, allow_self_signed. Le opzioni omesse prendono i valori predefiniti da GET /check-types.

Creare un controllo di sito web con una parola chiave:

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 risposta (201) è il monitor. provisioning.state passa a synced non appena le località lo hanno preso in carico, status da pending a up dopo il primo controllo:

{
  "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"
  }
}

Valori di stato: pending, up, degraded, down, paused.

Mettere in pausa un monitor durante un deploy e riprenderlo dopo:

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 e tempi di risposta

L’uptime si calcola dai disservizi (incidenti di gravità major); gli avvisi, come un certificato in scadenza, non contano. Non ancora controllato significa null, non 100.

EndpointCosa fa
GET /monitors/{id}/uptime Uptime in percentuale per le ultime 24 ore, 7 giorni e 30 giorni
GET /monitors/{id}/daily-uptime Uptime per giorno di calendario (UTC), days 1–90, predefinito 30
GET /monitors/{id}/response-times Tempo di risposta e disponibilità per località, range 24h, 7d o 30d; punti orari, giornalieri per 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}}

Tempi di risposta (abbreviati):

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}
      ]
    }
  }
}

Server

Un server è una macchina con l’agent installato, che riporta CPU, memoria, carico, dischi, rete e servizi. La creazione di un server restituisce il comando di installazione monouso; eseguilo sulla macchina e il server compare poco dopo.

EndpointCosa fa
GET /servers Elenca; filtro ids
POST /servers Crea; la risposta contiene install_command (Linux) e install_command_freebsd
GET /servers/{id} Un server con inventario, ultimo snapshot e soglie
PATCH /servers/{id} Rinomina, scegli i services monitorati, imposta le thresholds
DELETE /servers/{id} Elimina (204); l’agent viene rimosso dal monitoraggio
POST /servers/{id}/pause Metti in pausa; gli incidenti aperti vengono chiusi
POST /servers/{id}/resume Riprendi
POST /servers/{id}/install-token Nuovo comando di installazione; rotate_key=true emette anche una nuova chiave dell’agent
GET /servers/{id}/metrics Serie per i grafici, range 24h, 7d o 30d: metrica → contesto → [unix time, avg, min, max]
CampoDescrizione
name Nome visualizzato, fino a 100 caratteri. Obbligatorio alla creazione.
services Nomi dei servizi che l’agent deve monitorare, per esempio ["nginx", "php8.4-fpm", "mariadb"]; fino a 200. Il server riporta ciò che ha trovato in discovered.services.
thresholds Soglie di avviso: cpu_max (percentuale), load_max_per_cpu, mem_min_pavail (percentuale libera), fs_warn e fs_crit (percentuale usata), inode_warn, agent_nodata_minutes, per punto di mount sotto filesystems, e le espressioni regolari fs_types, fs_exclude, net_exclude. I valori omessi mantengono i valori predefiniti.

Aggiungere un server e leggere il comando di installazione dalla risposta:

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"
  }
}

Monitorare tre servizi e avvisare all’80 per cento di 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}
  }'

Incidenti

Un incidente è un disservizio o un avviso di un monitor o di un server, da started_at fino a resolved_at. Ogni incidente porta il suo numero di avviso, lo stesso mostrato dall’e-mail di avviso.

EndpointCosa fa
GET /incidents Dal più recente; filtri monitor_id, status (open o closed), open=1 (disservizi aperti senza avvisi), from e to (date)
GET /incidents/{id} Un incidente con la sua cronologia: quando ogni località è andata giù ed è tornata, e la riparazione che lo ha risolto

Incidenti aperti:

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}
}

Campi utili: subject_type (monitor o server), severity (major, warning, info), cause (per esempio unreachable, network_issue, certificate_expiring, heartbeat_missed), duration_seconds, affected_locations e, finché è aperto, failure_reason con gli ultimi valori del controllo.

Status page

Una status page mostra monitor scelti al pubblico o al tuo team, sul nostro dominio o sul tuo. Gli avvisi annunciano manutenzioni o spiegano un incidente in corso.

EndpointCosa fa
GET /status-pages Elenca
POST /status-pages Crea
GET /status-pages/{id} Una pagina con monitor, avvisi e stato dei suoi domini
PATCH /status-pages/{id} Aggiorna; monitors sostituisce l’intera lista
DELETE /status-pages/{id} Elimina (204)
POST /status-pages/{id}/notices Aggiungi un avviso
PUT /status-pages/{id}/notices/{notice} Aggiorna un avviso
DELETE /status-pages/{id}/notices/{notice} Rimuovi un avviso (204)
CampoDescrizione
slug Parte dell’indirizzo, 3–63 caratteri, lettere minuscole, cifre e trattini; univoco. Obbligatorio.
title Titolo della pagina. Obbligatorio.
description Breve testo sotto il titolo, fino a 2000 caratteri.
logo_url Indirizzo HTTPS di un logo.
custom_domain Dominio proprio come status.example.com; richiede un piano con domini di stato propri.
is_public Pubblica (true) o solo per gli utenti con accesso.
monitors Lista ordinata di {"id": "<monitor UUID>", "display_name": "…", "group": "…"}; display_name e group sono facoltativi.

Un avviso ha kind (maintenance, info o incident), title, body (facoltativo, fino a 5000 caratteri), starts_at e un ends_at facoltativo.

Creare una status page pubblica con due monitor:

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"}
    ]
  }'

Annunciare una finestra di manutenzione:

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"
  }'

Canali di notifica

Un canale di notifica è un modo per raggiungere qualcuno: un indirizzo e-mail, una chat Telegram, un webhook o i dispositivi push di un utente. Un canale riceve gli avvisi di tutti i monitor dello spazio di lavoro, oppure solo quelli dei monitor in monitor_ids. Quali tipi di canale include il tuo piano: GET /notification-channel-types.

EndpointCosa fa
GET /notification-channels Elenca
POST /notification-channels Crea; per un webhook il secret di firma è presente solo in questa risposta
GET /notification-channels/{id} Un canale
PATCH /notification-channels/{id} Aggiorna; il tipo non può cambiare
DELETE /notification-channels/{id} Elimina (204)
POST /notification-channels/{id}/test Invia una notifica di test (202); un indirizzo e-mail non confermato riceve invece di nuovo il link di conferma
GET /notification-channel-types Tipi di canale con available e paid
CampoDescrizione
type email, telegram, webhook o push. Obbligatorio, non modificabile in seguito.
name Nome visualizzato. Obbligatorio.
config A seconda del tipo: {"email": "…"}, {"chat_id": "…"} o {"url": "https://…"}. Push non richiede configurazione. Un nuovo indirizzo e-mail va confermato tramite link prima che partano gli avvisi.
monitor_ids UUID dei monitor a cui si riferisce questo canale; omettilo per tutti i monitor.
quiet_hours {"start": "22:00", "end": "07:00", "timezone": "Europe/Berlin"}: nessun avviso in quella fascia.
escalation_delay_minutes Avvisare questo canale solo quando un disservizio dura così a lungo (0–1440).
notify_recovery Inviare anche la fine allarme (true o false).
is_active Attivare o disattivare il canale senza eliminarlo.

Creare un canale webhook per due monitor e conservare il 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 canale webhook invia ogni avviso in POST come JSON al tuo URL, con un timeout di 10 secondi e senza reindirizzamenti. La destinazione deve essere un indirizzo pubblico.

Header: X-Webhook-Timestamp (tempo Unix), X-Webhook-Signature (sha256= seguito dall’HMAC-SHA256 di <timestamp>.<body> con il secret del canale come chiave) e User-Agent: Uptime-Webhook/1.

event è down, recovered, paused o test. Per un avviso di monitor il body contiene monitor (id, name, target) e incident (id, severity, cause, started_at, resolved_at, duration_seconds, affected_locations); per un avviso di server server (id, name) e incident con problem al posto delle località. subject è il titolo dell’avviso nella lingua del canale.

Body di un avviso di down:

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 prima di fidarti del body: calcola l’HMAC sul body grezzo esattamente come ricevuto e confrontalo in tempo costante. Rifiuta i timestamp più vecchi di qualche minuto.

Controllare la firma in una shell:

expected="sha256=$(printf '%s.%s' "$TIMESTAMP" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')"
[ "$expected" = "$SIGNATURE" ] && echo "valid"

Riepilogo della dashboard

GET /dashboard restituisce i conteggi dietro i riquadri della panoramica: monitor per stato (i server contano con le loro unità di piano), server per stato e numero di incidenti aperti. Basta uno qualsiasi degli scope monitors:read, servers:read o incidents:read per accedervi.

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
  }
}

Domande frequenti

Quale piano include l’API?

I token API sono inclusi dal piano Business in su. Nei piani più piccoli vedi la sezione in Il mio account disattivata, con un link per il passaggio a un piano superiore. Tutto il resto di Centoculus funziona senza l’API.

Un token può fare tutto ciò che fa il mio account?

No. Un token raggiunge solo le aree per cui gli hai dato degli scope, e mai fatturazione, membri del team, altri token, sicurezza dell’account o riparazioni. Quelli restano nell’app.

Esiste una sandbox?

Per esplorare, usa un token con soli scope di lettura e crea monitor di prova sul piano gratuito di un secondo account. I monitor che crei contano per il tuo piano come quelli creati nell’app.

Come porto gli avvisi nel mio sistema?

Crea un canale webhook e verifica la firma di ogni consegna. Ogni disservizio, ripristino e pausa raggiunge il tuo URL in pochi secondi, con monitor, causa e località interessate in JSON.

L’API cambia?

La versione è nell’indirizzo (/api/v1). Nuovi campi possono essere aggiunti alle risposte in qualsiasi momento; all’interno di una versione i campi non vengono rimossi né rinominati. Leggi ciò che ti serve e ignora il resto.

Pronto ad automatizzare il tuo monitoraggio?

I token API sono inclusi dal piano Business in su. Confronta i piani, oppure inizia gratis e passa a un piano superiore quando i tuoi script sono pronti.