Error Codes & Rate Limits
Formato de erro
Response
{
"error": "Bad Request",
"message": "Descrição do erro.",
"details": [
{ "field": "fullname", "message": "Campo obrigatório" }
]
}Códigos HTTP
| Código | Nome | Quando ocorre |
|---|---|---|
| 200 | OK | Request processada com sucesso |
| 201 | Created | Registro criado com sucesso |
| 400 | Bad Request | Dados inválidos ou campos obrigatórios ausentes |
| 401 | Unauthorized | Token ausente, inválido ou expirado |
| 403 | Forbidden | Sem permissão para esta operação |
| 404 | Not Found | Registro não encontrado |
| 429 | Too Many Requests | Rate limit excedido |
| 500 | Internal Server Error | Erro interno |
Rate Limits
Os limites são aplicados por conta e variam conforme o recurso. Quando um limite é excedido, a API retorna 429 com o header Retry-After: espere o tempo indicado antes de tentar de novo.
Boas práticas
- Implemente retry com backoff exponencial para erros 429 e 5xx
- Trate erros 401 solicitando um novo token
- Valide dados no cliente antes de enviar para a API