Erros e limites da API

Referência dos erros da API do Bot do Afiliado (invalid_api_key, conversion_failed, payload inválido) e dos limites de uso, como o batch de 150 URLs.

Referência de erros e limites da API. Veja também autenticação.

Erros comuns

HTTP	Erro	Significado
401	`invalid_api_key`	`X-API-Key` ausente ou inválida.
400	`conversion_failed`	Sem rota/conversor ativo para a URL (ou credenciais faltando). Não é erro de scraping.
400	payload inválido	Corpo não é JSON válido ou não respeita o schema (ex.: `url` ausente).
5xx	erro inesperado	Falha de rede, indisponibilidade de provider ou exceção não tratada.

No modo batch (/convert-links), falhas de conversão de itens não retornam 400 — cada item traz ok: false + error. O 400 fica para erro de payload/auth.

Limites

Batch: até 150 URLs por requisição.
Histórico: history_limit de 1 a 50 (padrão 10) no /product.
Faça retry apenas dos itens que falharam e use lotes menores em caso de timeout.

Boas práticas

Trate success/ok antes de usar affiliate_url/final_url.
Implemente backoff em caso de 5xx.
Não exponha a API key no cliente.

Perguntas frequentes

conversion_failed é erro de scraping?

Não. Significa que não há rota/conversor ativo elegível para a URL (ou faltam credenciais do provider).

Qual o limite de URLs por requisição?

150 no modo batch do /convert-links.

Pronto para automatizar suas comissões?

Crie seu bot, conecte suas integrações e comece a converter links em segundos.

Criar meu bot Ver módulos e preços