Bot do Afiliado

Autenticação: API keys (X-API-Key)

Como gerar e usar API keys do Bot do Afiliado, autenticar com o header X-API-Key e revogar chaves no painel. Requer o módulo de API.

Nesta página

A API usa API keys geradas no painel. Cada chave tem o formato bk_<prefixo>.<segredo> e é enviada no header X-API-Key. O recurso exige o módulo de API ativo.

Gerar uma chave

  1. Ative o módulo de API.
  2. No painel do bot, abra a aba API Keys.
  3. Clique em Criar e dê um nome (opcional).
  4. Copie a chave completa — ela é exibida apenas uma vez.

📸 Print sugerido: modal “Chave criada (copie agora)” e a lista de chaves mostrando só o prefixo.

Usar nas chamadas

curl -X POST "https://botdoafiliado.com/api/v1/convert-links" \
  -H "content-type: application/json" \
  -H "X-API-Key: bk_xxxxxx.xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" \
  -d '{"url":"https://www.aliexpress.com/item/100500..."}'

Segurança

  • A chave completa não fica armazenada em texto puro — o painel guarda apenas um hash e mostra o prefixo.
  • Revogue chaves comprometidas na aba API Keys (efeito imediato).
  • Nunca exponha a chave no front-end; use-a apenas no servidor.

Próximo: faça sua primeira conversão em convert-links.

Perguntas frequentes

A chave aparece de novo depois?

Não. A chave completa é exibida apenas no momento da criação. Depois, o painel mostra só o prefixo. Guarde-a com segurança.

Como revogo uma chave?

Na aba API Keys, use a opção Revogar ao lado da chave. Ela deixa de funcionar imediatamente.

Posso ter várias chaves?

Sim. Crie chaves separadas por integração/sistema e revogue individualmente quando necessário.

Preciso enviar bot_id também?

Se você envia uma X-API-Key válida, o bot_id pode ser omitido. Sem a chave, o bot_id passa a ser obrigatório no corpo.

Pronto para automatizar suas comissões?

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