Bot do Afiliado

API REST: visão geral

Visão geral da API REST do Bot do Afiliado — base URL, autenticação por API key, endpoints de conversão e produto, formatos e limites.

Nesta página

A API REST permite converter links e obter dados de produto a partir de qualquer sistema. É a mesma engine usada pelo bot do Telegram.

Base URL

https://botdoafiliado.com/api/v1/

Autenticação

Use o header X-API-Key com uma chave gerada no painel (formato bk_...). Requer o módulo de API ativo. Veja autenticação.

X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

EndpointMétodoO que faz
/api/v1/convert-linksPOSTConverte 1 ou vários links (até 150). Veja convert-links.
/api/v1/productPOSTDados do produto + histórico de preço. Veja product.
/api/v1/search-productsPOSTBusca produtos por título no marketplace escolhido (site: shopee, aliexpress, amazon).
/api/v1/convertPOSTConversão unitária (legado). Veja convert (legado).

Formatos e limites

  • Corpo e resposta em JSON.
  • Batch: até 150 URLs por requisição em /convert-links.
  • Erros e limites detalhados em erros e limites.
  • Especificação interativa em Swagger/OpenAPI.

Próximos passos

  1. Ative o módulo de API.
  2. Gere uma API key.
  3. Faça sua primeira chamada em convert-links.

Perguntas frequentes

Preciso de qual módulo para usar a API?

Do módulo de API. Com ele ativo, você gera uma API key no painel e usa o header X-API-Key.

Qual a base URL?

As rotas ficam em https://botdoafiliado.com/api/v1/. Cada endpoint está documentado nesta seção.

Dá para usar entre Workers sem sair para a internet?

Sim, via Service Binding (RPC). Veja a página RPC / Service Binding.

Pronto para automatizar suas comissões?

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