API do Afiliados
API do Afiliados: as suas ofertas no n8n
Receba as ofertas novas, gere o seu link de afiliado e aprove para a fila sem abrir o painel. Uma chave, endereços simples e respostas em português quando algo não dá certo.
- 18 chamadas prontas
- Chave com permissões por uso
- Resposta sempre em JSON
- Erros em português
Funciona com
As lojas, as redes e os canais são os do seu plano e do seu painel.
Primeiros passos
A primeira chamada da API do Afiliados: o link do produto vai, o seu link volta.
A API do Afiliados do Drope CRM liga o Afiliados Automático ao n8n, ao Make, a um robô do Telegram ou ao seu sistema. Ela lista as ofertas novas, gera o seu link de afiliado, aprova para a fila e mostra o histórico. Está no Afiliado Pro e no Afiliado Master.
- Endereço base https://dropecrm.com/api/afiliados, seguido do recurso: /offers, /links, /queue.
- Sua chave Em Afiliados, API, Criar chave. Começa com dcrm_ e aparece uma vez só.
- O que ela pode Só gerar link, organizar sem enviar ou tudo. Você escolhe ao criar.
- Limite por minuto Ao passar, vem 429 com retry_after. Nada foi feito naquela chamada.
- Sem número na chamada Vale para a conta inteira. A regra de envio diz qual número posta.
- Erros No erro vem success false e uma mensagem em português. A lista completa de códigos fica no painel, na área de API.
curl -X POST https://dropecrm.com/api/afiliados/links \
-H "Authorization: Bearer SUA_CHAVE" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.mercadolivre.com.br/p/MLB12345678"}'{
"success": true,
"data": {
"link": {
"url": "https://meli.la/2xYz9Ab",
"long_url": "https://www.mercadolivre.com.br/p/MLB12345678?...",
"store": "mercadolivre",
"store_label": "Mercado Livre"
}
}
}Referência
As 18 chamadas da API do Afiliados, grupo por grupo.
Cada linha é uma chamada de verdade. Toda oferta e todo item da fila vêm com status para o programa e status_label para mostrar.
Ofertas
afiliados:read
afiliados:write
afiliados:send
Aprovar pede a permissão de enviar e o envio pela API no plano.
-
GET
/Lista as ofertas por situação, das mais novas para as mais antigas, com filtro por fonte, loja, busca e horário.api/ afiliados/ offers -
GET
/Tudo de uma oferta. Com ?preview=1, a mensagem pronta como vai chegar no destino, sem enviar.api/ afiliados/ offers/ {id} -
POST
/Ajusta título, preço, preço antigo, cupom, imagem ou a linha extra de uma oferta para aprovar. Também aceita PATCH.api/ afiliados/ offers/ {id} -
POST
/Aprova a oferta para uma regra: ela entra na fila do número que posta. Aprovar duas vezes não duplica.api/ afiliados/ offers/ {id}/ approve -
POST
/Descarta a oferta.api/ afiliados/ offers/ {id}/ skip -
POST
/Desfaz o descarte: a oferta volta para aprovar.api/ afiliados/ offers/ {id}/ restore -
POST
/Importa o link de um produto: a oferta entra para aprovar, já com o seu link de afiliado.api/ afiliados/ offers/ import
Link de afiliado
afiliados:links
Uma chave só com esta permissão serve de robô de links: se vazar, não mexe em oferta nem envia.
-
POST
/Transforma o link de um produto no seu link de afiliado.api/ afiliados/ links
Fila e histórico
afiliados:read
afiliados:write
afiliados:send
-
GET
/O que vai sair, em que ordem, quando e por qual número.api/ afiliados/ queue -
GET
/Como está um envio: quantos grupos receberam e o motivo do que não foi.api/ afiliados/ queue/ {id} -
POST
/Tira o item da fila; a oferta volta para aprovar.api/ afiliados/ queue/ {id}/ cancel -
POST
/Manda o item agora, sem esperar a vez.api/ afiliados/ queue/ {id}/ send-now -
GET
/O que foi enviado e o que não foi, com o motivo em português.api/ afiliados/ history
Conta, fontes e regras
afiliados:read
afiliados:write
Criar fontes e regras continua no painel. Ligar uma regra pede também a permissão de enviar.
-
GET
/Diz se o Afiliados está pronto para enviar e, se não, o que falta, com o limite de hoje.api/ afiliados/ status -
GET
/Para onde as ofertas podem ir: redes, canais e o número que posta.api/ afiliados/ destinations -
GET
/As fontes (lojas e grupos de ofertas) e como cada uma está.api/ afiliados/ sources -
GET
/As regras de envio e como cada uma está.api/ afiliados/ rules -
POST
/Liga ou pausa uma regra. Pausar tira da fila o que ela ainda ia mandar.api/ afiliados/ rules/ {id}
Veja funcionando
Entre no grupo de demonstração e veja as ofertas que a API pode aprovar.
Um grupo de WhatsApp que só o sistema abastece. Sem ninguém copiando e colando, sem link de outra pessoa.
- Oferta real, publicada no ritmo de uma regra
- Foto, preço, desconto e cupom em cada mensagem
- É assim que vai chegar no seu grupo
Perguntas frequentes
API do Afiliados: as dúvidas mais comuns.
Dúvida sobre a chave, as permissões ou o limite? Fala com a gente.
Está no Afiliado Pro e no Afiliado Master. Aprovar, enviar agora e ligar regra pela API pedem também o envio pela API, que está no Afiliado Pro e no Afiliado Master. Sem ele, a API vê, organiza e gera links, e nada sai.
Não necessariamente. No painel, em Afiliados, API, tem o fluxo pronto para copiar no n8n e o passo a passo do Make. Com um programador, qualquer sistema que faça uma chamada pela internet funciona.
Não. Criar e editar fontes e regras continua no painel. Pela API você liga ou pausa uma regra que já existe.
Só as de enviar: aprovar, enviar agora e ligar regra. Elas saem nos seus grupos ou canais. Listar, ver, editar, descartar, importar e gerar link não enviam nada.
As lojas do seu plano, com a sua conta de afiliado da loja conectada no painel. Link de outra loja volta com UNSUPPORTED_URL e a lista das que valem.
No teste grátis você usa o Afiliados Automático pelo painel. A API entra quando você assina um plano que tem ela.
Continue por aqui