Todas as respostas de erro seguem o mesmo formato JSON.
{
"error": "Descrição do erro"
}
Códigos de erro
| Status | Erro | Causa |
|---|
400 | Bad Request | Body ou parâmetros inválidos |
401 | Unauthorized | API Key ausente, inválida ou revogada |
403 | Forbidden | Sem permissão para o recurso |
404 | Not Found | Recurso não encontrado |
429 | Too Many Requests | Rate limit excedido (60 req/min) |
500 | Internal Server Error | Erro interno — contate suporte |
Exemplos
Key inválida (401)
curl -H "Authorization: Bearer ik_live_invalida" \
https://api.useintegra.com.br/api/v1/campaigns
{
"error": "Invalid or revoked API key"
}
Recurso não encontrado (404)
curl -H "Authorization: Bearer ik_live_xxx" \
https://api.useintegra.com.br/api/v1/campaigns/id-inexistente
{
"error": "Campaign not found"
}
Rate limit excedido (429)
{
"error": "Rate limit exceeded. Try again later."
}
Sempre verifique o campo error na resposta para entender o que aconteceu. Os erros são descritivos em inglês para facilitar o debugging.
