Tokens de API e webhooks
Tokens pessoais somente leitura, webhooks da marca com entregas assinadas e a API de resolução do funil.
Tokens de API pessoais
Nas configurações da conta você pode criar tokens somente leitura (opcionalmente restritos a uma marca, com data de expiração). Eles dão acesso GET às suas campanhas, candidaturas, colaborações e licenças. Um token é exibido uma única vez; revogue-o a qualquer momento. Operações de escrita pela API ainda não são oferecidas.
Webhooks
Uma marca pode cadastrar endpoints HTTPS e assinar eventos: campanha publicada, candidatura enviada, acordo criado, colaboração concluída, licença prestes a expirar. Cada entrega é assinada (X-ProvenReel-Signature: t=…,v1=…, HMAC-SHA256 do timestamp e do corpo com o seu segredo) e reenviada após 1, 5, 30, 120 e 720 minutos antes de ser marcada como esgotada. O registro de entregas, um ping de teste, a pausa e a rotação do segredo estão na página de webhooks.
Os payloads carregam apenas identificadores, nomes de exibição e totais acordados.
API de resolução do funil
Para links no domínio da marca: o seu funil chama um endpoint de resolução assinado para converter um slug personalizado em uma referência de atribuição antes da loja, e informa as conversões por um feed de eventos assinado. O contrato, os cabeçalhos e a rotação do segredo estão na página de integrações.
Ainda em dúvida? Escreva para uma pessoa na página de ajuda.