Erros da API de Leads
A API retorna erros em formato JSON padronizado, com code estável para tratamento no sistema externo.
Formato padrão de erro
{
"error": {
"code": "invalid_cursor",
"message": "Cursor inválido."
}
}400 invalid_parameter
Um parâmetro não reconhecido ou incompatível foi enviado.
- Revise nomes, tipos e combinação de parâmetros.
400 invalid_cursor
O cursor informado não pode ser lido ou não pertence à consulta atual.
- Use apenas o valor retornado em page_info.next_cursor.
400 invalid_updated_since
A data de updated_since não está em formato aceito.
- Envie uma data ISO 8601, por exemplo 2026-05-06T00:00:00Z.
400 invalid_limit
O limit está fora do intervalo aceito ou não é numérico.
- Ajuste o tamanho da página antes de repetir a chamada.
401 unauthorized
O token está ausente, inválido ou revogado.
- Confira o header Authorization e gere novo token se necessário.
404 not_found
O lead consultado não existe no escopo associado ao token.
- Confirme o lead_id e a loja ou conta ligada ao token.
503 integration_disabled
A integração está desabilitada para a conta ou token.
- Reative a integração no painel ou fale com o responsável pela conta.
500 internal_error
Ocorreu erro inesperado ao processar a chamada.
- Registre horário, endpoint, request_id se houver e tente novamente.
Como diagnosticar problemas
Separe erros de parâmetro, autenticação, disponibilidade de integração e falhas inesperadas. Isso evita tratar invalid_cursor da mesma forma que unauthorized ou integration_disabled.
Em automações recorrentes, registre endpoint, parâmetros, horário e código de erro. Não registre token completo em logs.
O que enviar ao suporte
Envie apenas dados necessários para diagnóstico técnico.
- Endpoint chamado e horário aproximado.
- Código público de erro e mensagem retornada.
- Parâmetros usados sem incluir token.
- Se a falha ocorreu em carga inicial, cursor ou updated_since.