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.
- Crea un token in Il mio account → Token API nell’app web o nell’app per il telefono e scegli i suoi scope.
- Copia subito il token: viene mostrato una sola volta.
- 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.
| Scope | Consente |
|---|---|
monitors:read | Elencare e mostrare monitor, uptime, uptime giornaliero, tempi di risposta, tipi di controllo, località, riepilogo della dashboard |
monitors:write | Creare, aggiornare, eliminare, mettere in pausa e riprendere i monitor |
servers:read | Elencare e mostrare i server e le loro metriche |
servers:write | Creare, aggiornare, eliminare, mettere in pausa e riprendere i server; nuovo comando di installazione dell’agent |
incidents:read | Elencare e mostrare gli incidenti, riepilogo della dashboard |
status-pages:read | Elencare e mostrare le status page |
status-pages:write | Creare, aggiornare ed eliminare le status page e i loro avvisi |
notifications:read | Elencare e mostrare i canali di notifica e i tipi di canale |
notifications:write | Creare, 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 sottodataconlinksemeta. - 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
pageeper_page;metacontienecurrent_page,last_page,per_pageetotal. 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_idquando 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.
| Stato | Significato |
|---|---|
401 | Token mancante, non valido, scaduto o revocato. |
402 | Il monitoraggio è in pausa perché il credito prepagato è esaurito (clienti dei reseller); riprende dopo una ricarica. |
403 | Al token manca lo scope, l’endpoint è chiuso ai token API oppure il tuo piano non include la funzione. |
404 | Non trovato, oppure non nel tuo spazio di lavoro. |
409 | Conflitto, per esempio la conferma di un indirizzo e-mail già confermato. |
422 | Validazione non riuscita; vedi errors. Quando si raggiunge il limite del piano, upgrade indica la funzione che un piano superiore sblocca. |
429 | Troppe 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.
| Endpoint | Cosa 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
| Campo | Descrizione |
|---|---|
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.
| Endpoint | Cosa 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.
| Endpoint | Cosa 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] |
| Campo | Descrizione |
|---|---|
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.
| Endpoint | Cosa 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.
| Endpoint | Cosa 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) |
| Campo | Descrizione |
|---|---|
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.
| Endpoint | Cosa 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 |
| Campo | Descrizione |
|---|---|
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.