Vai al contenuto principale
GET
curl

Panoramica

Restituisce lo stato di ogni servizio Didit, lo stato complessivo e gli incidenti in corso o risolti negli ultimi 7 giorni. L’endpoint è pubblico: non inviare alcun header di autenticazione. La risposta non contiene dati dell’organizzazione ed è uguale per ogni chiamante.

Quando usarlo

  • Widget di stato: mostra ai tuoi utenti o al tuo team di supporto se un servizio Didit è degradato in questo momento.
  • Controllo dello stato dell’integrazione: prima di incolpare il tuo codice per controlli lenti o falliti, verifica se Didit segnala un incidente sul servizio che stai chiamando.
  • Storico degli incidenti: elenca che cosa è successo negli ultimi 7 giorni e quanto è durato ciascun incidente.
Per verificare solo che l’API sia raggiungibile, usa invece l’healthcheck.

Polling

Le risposte sono memorizzate nella cache per 30 secondi, quindi non effettuare il polling più di una volta ogni 30 secondi. updated_at indica quando Didit ha generato la risposta che hai ricevuto. Si applica inoltre un limite di frequenza per le richieste GET di 600 richieste al minuto per indirizzo.

Servizi

services elenca tutti i servizi, con o senza incidenti. Effettua la corrispondenza su key: name è un nome visualizzato in inglese e può cambiare. Lo status di ciascun servizio è operational, degraded o down. È operational quando il servizio non ha incidenti in corso; altrimenti è lo stato peggiore tra i suoi incidenti in corso. Lo status di primo livello è lo stato peggiore tra tutti i servizi.

Incidenti

incidents elenca ogni incidente in corso e gli incidenti risolti negli ultimi 7 giorni, dal più recente al più vecchio in base a started_at. Sono elencati al massimo 50 incidenti risolti.
  • state è degraded o down. Un incidente risolto mantiene l’ultimo stato che aveva.
  • status è ongoing finché il servizio non si ripristina, poi diventa resolved.
  • resolved_at e duration_minutes sono null mentre l’incidente è in corso.
  • affected e country_name indicano il paese o il registro interessato, per esempio Brazil (CPF) e Brazil. Sono vuoti quando l’incidente non è legato a un paese o a un registro.
  • title e body sono in inglese. Per mostrare l’incidente in un’altra lingua, crea il tuo testo a partire da service, state e country_name.

Esempio di risposta

Correlati

  • Healthcheck: una sonda pubblica di disponibilità che non richiede nemmeno un header di autenticazione.
  • Webhook di alert: ricevi alert.service.degraded e alert.service.recovered inviati al tuo endpoint per i servizi usati dalla tua organizzazione.
  • Limitazione della frequenza

Risposta

Stato attuale del servizio.

Stato pubblico dei servizi: lo stato di ciascun servizio Didit, lo stato complessivo e gli incidenti in corso o risolti negli ultimi 7 giorni.

status
enum<string>
obbligatorio

Lo stato peggiore tra tutti i servizi in questo momento, determinato esclusivamente dagli incidenti in corso.

Opzioni disponibili:
operational,
degraded,
down
Esempio:

"degraded"

updated_at
string<date-time>
obbligatorio

Quando Didit ha generato questa risposta (ISO 8601, UTC). Le risposte sono memorizzate nella cache per 30 secondi, quindi possono risalire a un massimo di 30 secondi prima.

Esempio:

"2026-10-13T09:41:07.512345Z"

services
object[]
obbligatorio

Una voce per servizio, con tutti i servizi sempre elencati.

incidents
object[]
obbligatorio

started_at più recente per primo. Ogni incidente in corso, più gli incidenti risolti negli ultimi 7 giorni (al massimo 50 incidenti risolti). Vuoto se non si è verificato nulla in quel periodo.

Ultima modifica il 7 novembre 2026