Tratamento de erros

A API retorna códigos HTTP padrão para indicar sucesso ou falha de uma requisição.

Códigos HTTP

Código	Significado
400	Requisição malformada
401	Token ausente, inválido ou expirado
403	Sem permissão para o recurso
404	Recurso não encontrado
422	Erro de validação nos dados enviados
429	Limite de requisições excedido
500	Erro interno — entre em contato com o suporte

No fluxo de autenticação (Keycloak), erros seguem o formato padrão OAuth2:

{
  "error": "invalid_grant",
  "error_description": "Invalid user credentials"
}

Para os seis endpoints aprovados, gere um token válido no Keycloak e confira o código HTTP e a mensagem retornada em cada chamada — o formato exato do corpo de erro pode variar por endpoint.