Erros & rate limit
Formato de erro, códigos de status HTTP e limite de requisições.
Formato de erro
Erros seguem o mesmo envelope das respostas de sucesso, com success: false e detalhes
em errors:
{
"success": false,
"message": "A validação falhou.",
"data": null,
"errors": { "field": "assunto", "message": "O campo assunto é obrigatório." }
}Códigos de status
| Status | Significado | Causa típica |
|---|---|---|
400 | Requisição inválida | JSON malformado / parâmetros inválidos. |
401 | Não autenticado | HSDesk Key ausente, inválida ou revogada. |
404 | Não encontrado | Recurso inexistente. |
422 | Regra de negócio | Ex.: payload válido, mas não foi possível resolver o contato. |
429 | Rate limit | Excedeu o limite por credencial. |
Rate limit
O limite é por credencial: padrão 120 requisições por minuto. Ao exceder, a API
responde 429. Implemente backoff e reduza a frequência das chamadas ao receber 429.