Pular para o conteúdo

Erros e limites

A API usa os códigos de status HTTP padrão:

CódigoSignificado
200 OKRequisição bem-sucedida
201 CreatedRecurso criado
202 AcceptedAceito para processamento assíncrono
204 No ContentSucesso sem corpo de resposta
400 Bad RequestPayload inválido ou erro de validação
401 UnauthorizedToken ausente, inválido ou expirado
403 ForbiddenSem permissão para o recurso
404 Not FoundRecurso não encontrado
429 Too Many RequestsLimite de requisições excedido
5xxErro interno — tente novamente com backoff

Erros de validação seguem o padrão do Django REST Framework:

{
"campo": ["Mensagem de erro para este campo."],
"detail": "Mensagem geral, quando aplicável."
}
  • Backoff exponencial em 429 e 5xx.
  • Trate 401 renovando o token (ver Autenticação).
  • Idempotência: evite reenviar POST sem confirmar o resultado do anterior.