Erros e limites
Códigos de status
Seção intitulada “Códigos de status”A API usa os códigos de status HTTP padrão:
| Código | Significado |
|---|---|
200 OK | Requisição bem-sucedida |
201 Created | Recurso criado |
202 Accepted | Aceito para processamento assíncrono |
204 No Content | Sucesso sem corpo de resposta |
400 Bad Request | Payload inválido ou erro de validação |
401 Unauthorized | Token ausente, inválido ou expirado |
403 Forbidden | Sem permissão para o recurso |
404 Not Found | Recurso não encontrado |
429 Too Many Requests | Limite de requisições excedido |
5xx | Erro interno — tente novamente com backoff |
Formato de erro
Seção intitulada “Formato de erro”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."}Boas práticas
Seção intitulada “Boas práticas”- Backoff exponencial em
429e5xx. - Trate
401renovando o token (ver Autenticação). - Idempotência: evite reenviar
POSTsem confirmar o resultado do anterior.