Guia

Erros

Erros seguem códigos HTTP padrão e um corpo JSON com detalhes para depuração.

Formato de erro

Exemplo

{
  "code": "INVALID_TOKEN",
  "message": "O token informado expirou.",
  "details": {}
}

Código	Nome	Descrição
200	OK	Requisição executada com sucesso.
201	Created	Recurso criado com sucesso.
400	Bad Request	Parâmetros inválidos ou corpo malformado.
401	Unauthorized	Token ausente, inválido ou expirado.
403	Forbidden	Token válido mas sem permissão.
404	Not Found	Recurso não encontrado.
422	Unprocessable Entity	Validação de regra de negócio falhou.
429	Too Many Requests	Limite de requisições atingido.
500	Internal Server Error	Erro inesperado no servidor.