Pular para o conteúdo principal
GET
curl

Visão geral

Retorna o estado de cada serviço da Didit, o estado geral e os incidentes em andamento ou resolvidos nos últimos 7 dias. O endpoint é público: não envie nenhum cabeçalho de autenticação. A resposta não contém dados da organização e é a mesma para qualquer solicitante.

Quando usar

  • Widget de status: mostre aos seus usuários ou à sua equipe de suporte se algum serviço da Didit está degradado neste momento.
  • Verificação de saúde da integração: antes de culpar o seu próprio código por verificações lentas ou com falha, veja se a Didit informa um incidente no serviço que você chama.
  • Histórico de incidentes: liste o que aconteceu nos últimos 7 dias e quanto tempo durou cada incidente.
Para verificar apenas se a API está acessível, use o healthcheck.

Polling

As respostas ficam em cache por 30 segundos, portanto, faça polling no máximo uma vez a cada 30 segundos. updated_at indica quando a Didit gerou a resposta que você recebeu. Também se aplica um limite de requisições GET de 600 requisições por minuto por endereço IP.

Serviços

services lista todos os serviços, independentemente de terem um incidente. Faça a correspondência por key: name é um nome de exibição em inglês e pode mudar. O status de cada serviço é operational, degraded ou down. Ele é operational quando o serviço não tem nenhum incidente em andamento e, caso contrário, é o pior estado entre os seus incidentes em andamento. O status de nível superior é o pior estado entre todos os serviços.

Incidentes

incidents lista todos os incidentes em andamento e os incidentes resolvidos nos últimos 7 dias, do started_at mais recente para o mais antigo. São listados no máximo 50 incidentes resolvidos.
  • state é degraded ou down. Um incidente resolvido mantém o último estado que teve.
  • status é ongoing até o serviço se recuperar e, depois, resolved.
  • resolved_at e duration_minutes são null enquanto o incidente está em andamento.
  • affected e country_name indicam o país ou o registro afetado, por exemplo Brazil (CPF) e Brazil. Ficam vazios quando o incidente não está vinculado a um país ou registro.
  • title e body estão em inglês. Para exibir o incidente em outro idioma, monte o seu próprio texto a partir de service, state e country_name.

Exemplo de resposta

Relacionados

  • Healthcheck: uma sonda pública de atividade que também não exige cabeçalho de autenticação.
  • Webhooks de alerta: receba alert.service.degraded e alert.service.recovered no seu endpoint para os serviços que a sua organização usa.
  • Limite de requisições

Resposta

Status atual do serviço.

Status público dos serviços: o estado de cada serviço da Didit, o estado geral e os incidentes em andamento ou resolvidos nos últimos 7 dias.

status
enum<string>
obrigatório

O pior estado de qualquer serviço neste momento, determinado apenas pelos incidentes em andamento.

Opções disponíveis:
operational,
degraded,
down
Exemplo:

"degraded"

updated_at
string<date-time>
obrigatório

Quando a Didit gerou esta resposta (ISO 8601, UTC). As respostas ficam em cache por 30 segundos, então ela pode ter até 30 segundos de idade.

Exemplo:

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

services
object[]
obrigatório

Uma entrada por serviço; todos os serviços sempre aparecem na lista.

incidents
object[]
obrigatório

Os de started_at mais recente primeiro. Todos os incidentes em andamento, mais os incidentes resolvidos nos últimos 7 dias (no máximo 50 incidentes resolvidos). Vazio quando nada aconteceu nesse período.

Última modificação em 1 de novembro de 2026