[openaudit-search-api] Tratamento de erros padronizado (Error response) + não vazar detalhes sensíveis

[4lessandrodev]

Repo: openaudit-search-api

Tags: priority:medium type:feature area:api area:security

Visão geral

Padronizar respostas de erro para previsibilidade e segurança (sem stack traces em produção).

Contexto

Uma API robusta deve tratar erros de forma consistente e evitar vazamento de detalhes internos, caminhos de arquivo ou SQL bruto.

Descrição

Implementar handler global de erros:

• Mapear erros comuns:
  • 400 (q inválido)
  • 404 (rota inexistente)
  • 429 (rate limit)
  • 500 (erro interno)
• Resposta JSON mínima com:
  • error.code
  • error.message (genérica)
  • request_id

Logs internos podem ter detalhes (sem PII), mas response deve ser seguro.

Adicionar testes para cada erro.

Impacto

Melhora UX e segurança operacional. Reduz risco de exposição acidental de detalhes internos.

Referências

• https://github.com/OpenAudit-Brasil/openaudit-search-api/blob/main/README.md
• https://github.com/OpenAudit-Brasil/About/blob/main/SECURITY.md
• https://github.com/OpenAudit-Brasil/About/blob/main/RISK_POLICY.md

Definição de pronto

• Handler global implementado
• Erros mapeados retornam códigos corretos
• request_id incluído em erros
• Testes cobrindo erros mais comuns