Central de AjudaVoltar ao app →
Todos os artigos
FT-058Segurança & 2FA

Endpoints de monitoramento (health/ready)

Documentação dos endpoints públicos /api/health e /api/ready para monitoramento externo.

Atualizado em 8/6/2026
O Lefia expõe dois endpoints públicos e não autenticados para uso em ferramentas de monitoramento externo (UptimeRobot, Pingdom, Better Uptime, Datadog Synthetics).

/api/health



Liveness check básico. Retorna sempre 200 OK com payload pequeno enquanto o serviço estiver no ar.

{
  "status": "ok",
  "service": "nexio",
  "version": "0.1.0",
  "timestamp": "2026-05-05T...",
  "uptime_seconds": 1234
}


Use para: alertar se o serviço caiu (HTTP 5xx ou timeout).

/api/ready



Readiness check. Verifica dependências obrigatórias e retorna:

  • 200 OK se todas as dependências estão saudáveis
  • 503 Service Unavailable se algum check crítico falhou


Checks atuais:
  • supabase — SELECT id FROM roadmap_items LIMIT 1 com timeout de 2.5s
  • env — variáveis obrigatórias presentes (NEXT_PUBLIC_SUPABASE_URL, SUPABASE_SERVICE_ROLE_KEY, CREDENTIALS_ENCRYPTION_KEY)
  • sentry — NEXT_PUBLIC_SENTRY_DSN configurado (não bloqueia readiness, só informativo)


Privacidade



Nenhum endpoint expõe dado de tenant, payload, credenciais ou URLs internas. Apenas status, latência e versão.

Cache



Ambos respondem com Cache-Control: no-store para garantir leitura sempre fresh.

Veja também



  • pipeline-mensagens-fluxos — fluxos completos das mensagens
Endpoints de monitoramento (health/ready) · Lefia Help