Saltar al contenido principal
GET
curl

Descripción general

Devuelve el estado de cada servicio de Didit, el estado general y los incidentes en curso o resueltos en los últimos 7 días. El endpoint es público: no envíes ningún encabezado de autenticación. La respuesta no contiene datos de la organización y es la misma para cualquier solicitante.

Cuándo usarlo

  • Widget de estado: muestra a tus usuarios o a tu equipo de soporte si un servicio de Didit está degradado en este momento.
  • Comprobación del estado de la integración: antes de culpar a tu propio código de verificaciones lentas o fallidas, comprueba si Didit informa de un incidente en el servicio que invocas.
  • Historial de incidentes: consulta qué ocurrió en los últimos 7 días y cuánto duró cada incidente.
Para comprobar solo que la API es accesible, usa en su lugar el healthcheck.

Consultas periódicas

Las respuestas se almacenan en caché durante 30 segundos, así que no consultes más de una vez cada 30 segundos. updated_at indica cuándo generó Didit la respuesta que recibiste. También se aplica un límite de solicitudes GET de 600 por minuto por dirección IP.

Servicios

services enumera todos los servicios, tengan o no un incidente. Usa key para identificarlos: name es un nombre visible en inglés y puede cambiar. El status de cada servicio es operational, degraded o down. Es operational cuando el servicio no tiene ningún incidente en curso y, en caso contrario, el peor estado de sus incidentes en curso. El status de nivel superior es el peor estado de todos los servicios.

Incidentes

incidents enumera todos los incidentes en curso y los resueltos en los últimos 7 días, ordenados por started_at del más reciente al más antiguo. Se enumeran como máximo 50 incidentes resueltos.
  • state es degraded o down. Un incidente resuelto conserva el último estado que tuvo.
  • status es ongoing hasta que el servicio se recupera y, después, resolved.
  • resolved_at y duration_minutes son null mientras el incidente está en curso.
  • affected y country_name indican el país o el registro afectado, por ejemplo Brazil (CPF) y Brazil. Están vacíos cuando el incidente no está vinculado a un país o un registro.
  • title y body están en inglés. Para mostrar el incidente en otro idioma, genera tu propio texto a partir de service, state y country_name.

Ejemplo de respuesta

Relacionado

  • Healthcheck: una sonda pública de actividad que tampoco necesita un encabezado de autenticación.
  • Webhooks de alertas: recibe alert.service.degraded y alert.service.recovered en tu endpoint para los servicios que usa tu organización.
  • Límite de solicitudes

Respuesta

Estado actual del servicio.

Estado público del servicio: el estado de cada servicio de Didit, el estado general y los incidentes en curso o resueltos en los últimos 7 días.

status
enum<string>
requerido

El peor estado de cualquier servicio en este momento, determinado solo por las incidencias en curso.

Opciones disponibles:
operational,
degraded,
down
Ejemplo:

"degraded"

updated_at
string<date-time>
requerido

Cuándo generó Didit esta respuesta (ISO 8601, UTC). Las respuestas se almacenan en caché durante 30 segundos, por lo que puede tener hasta 30 segundos de antigüedad.

Ejemplo:

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

services
object[]
requerido

Una entrada por servicio; todos los servicios aparecen siempre.

incidents
object[]
requerido

Primero el started_at más reciente. Todos los incidentes en curso, más los incidentes resueltos en los últimos 7 días (como máximo 50 incidentes resueltos). Vacío cuando no ha ocurrido nada en ese periodo.

Última modificación el 1 de noviembre de 2026