Elenco dei controlli

Restituisce i controlli configurati sull'account, con l'esito dell'ultima verifica.

È la chiamata utile per portare lo stato dei tuoi servizi in una dashboard esterna o in un sistema di allerta che già usi.

• Metodo: GET
• Indirizzo: https://console.icbs.it/api/v1/monitoring
• Permesso: Monitoraggio — lettura

Parametri

Nessuno.

Esempio di richiesta

curl -H "Authorization: Bearer $ICBS_API_KEY" \
  https://console.icbs.it/api/v1/monitoring

Esempio di risposta

{
  "data": [
    {
      "id": 51,
      "name": "Sito principale",
      "type": "web",
      "target": "www.esempio.it",
      "domain": "esempio.it",
      "region": "eu-it",
      "intervalMinutes": 5,
      "enabled": true,
      "up": true,
      "lastCheckAt": "2026-08-05T21:15:00.000Z",
      "statusSince": "2026-07-28T08:02:00.000Z",
      "consecutiveFailures": 0
    }
  ]
}

Campi della risposta

Campo	Descrizione
type	Tipo di controllo: web, ping, dns e gli altri tipi disponibili.
target	Cosa viene controllato: indirizzo, host o nome DNS a seconda del tipo.
domain	Il dominio associato, null se il controllo non è legato a un dominio.
intervalMinutes	Ogni quanti minuti viene eseguito il controllo.
enabled	Se il controllo è attivo. Un controllo disattivato non viene eseguito.
up	Esito dell'ultima verifica: true se il servizio risponde.
lastCheckAt	Quando è stata eseguita l'ultima verifica.
statusSince	Da quando dura lo stato corrente. Con up: false è l'inizio del disservizio.
consecutiveFailures	Verifiche fallite di fila. Utile per distinguere un errore isolato da uno stabile.

Le impostazioni di notifica e le soglie di configurazione non compaiono in questa risposta.

Possibili errori

Codice	Causa
401	Chiave assente, non valida, scaduta o revocata.
403	Alla chiave manca il permesso Monitoraggio — lettura.
429	Superato il limite di richieste.

Chiavi limitate a domini specifici

Se la chiave è limitata ad alcuni domini, l'elenco contiene solo i controlli associati a quei domini. I controlli non legati ad alcun dominio non compaiono: appartengono all'account nel suo insieme, e una chiave ristretta non ha modo di rivendicarli.

Se ti aspetti un controllo che non vedi, verifica con Verificare la chiave se la chiave è ristretta e a quali domini.