Bot do Afiliado

Erros e limites da API REST

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.

Nesta página

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.
403 insufficient_scope A chave é válida, mas o nível dela não cobre esse endpoint (ex.: chave de Leitura chamando /convert-links).
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

O erro conversion_failed da API REST é problema de scraping do produto?

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 na API REST do Bot do Afiliado?

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 botVer módulos e preços