Saltar al contingut principal
GET
curl

Visió general

Retorna l’estat de tots els serveis de Didit, l’estat general i els incidents que estan en curs o que s’han resolt en els últims 7 dies. L’endpoint és públic: no enviïs cap capçalera d’autenticació. La resposta no conté dades de cap organització i és la mateixa per a tots els clients.

Quan utilitzar-lo

  • Widget d’estat: mostra als teus usuaris o a l’equip de suport si un servei de Didit està degradat en aquest moment.
  • Comprovació de l’estat de la integració: abans d’atribuir la lentitud o els errors de les comprovacions al teu propi codi, verifica si Didit informa d’un incident en el servei que crides.
  • Historial d’incidents: llista què ha passat en els últims 7 dies i quant va durar cada incident.
Per comprovar només que l’API és accessible, utilitza la comprovació de salut.

Consultes periòdiques

Les respostes es desen a la memòria cau durant 30 segons, així que no facis més d’una consulta cada 30 segons. updated_at indica quan Didit va generar la resposta que has rebut. També s’aplica un límit de freqüència de 600 sol·licituds GET per minut per adreça.

Serveis

services llista tots els serveis, tinguin o no un incident. Fes la coincidència amb key: name és un nom visible en anglès i pot canviar. L’status de cada servei és operational, degraded o down. És operational quan el servei no té cap incident en curs; en cas contrari, és el pitjor estat dels seus incidents en curs. L’status de nivell superior és el pitjor estat de tots els serveis.

Incidents

incidents llista tots els incidents en curs i els incidents resolts en els últims 7 dies, ordenats per started_at de més recent a més antic. Com a màxim, s’hi mostren 50 incidents resolts.
  • state és degraded o down. Un incident resolt conserva l’últim estat que va tenir.
  • status és ongoing fins que el servei es recupera; després és resolved.
  • resolved_at i duration_minutes són null mentre l’incident està en curs.
  • affected i country_name indiquen el país o el registre afectat, per exemple Brazil (CPF) i Brazil. Estan buits quan l’incident no està vinculat a cap país o registre.
  • title i body són en anglès. Per mostrar l’incident en un altre idioma, construeix el teu propi text a partir de service, state i country_name.

Exemple de resposta

Relacionat

Resposta

Estat actual del servei.

Estat públic del servei: l'estat de cada servei de Didit, l'estat general i els incidents en curs o resolts en els darrers 7 dies.

status
enum<string>
requerit

El pitjor estat de qualsevol servei en aquest moment, determinat únicament pels incidents en curs.

Opcions disponibles:
operational,
degraded,
down
Exemple:

"degraded"

updated_at
string<date-time>
requerit

Quan Didit ha generat aquesta resposta (ISO 8601, UTC). Les respostes s'emmagatzemen a la memòria cau durant 30 segons, de manera que poden tenir fins a 30 segons d'antiguitat.

Exemple:

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

services
object[]
requerit

Una entrada per servei, amb tots els serveis sempre llistats.

incidents
object[]
requerit

El started_at més recent primer. Tots els incidents en curs, més els incidents resolts en els darrers 7 dies (com a màxim 50 incidents resolts). Buit si no ha passat res durant aquest temps.

Darrera modificació el 7 de novembre del 2026