Token API e webhook

Token API personali

Dalle impostazioni dell'account puoi creare token in sola lettura (limitati, se vuoi, a un solo brand e con una scadenza). Danno accesso in GET a campagne, candidature, collaborazioni e licenze. Un token viene mostrato una sola volta; puoi revocarlo in qualsiasi momento. Le scritture tramite API non sono ancora disponibili.

Webhook

Un brand può registrare endpoint HTTPS e iscriversi agli eventi: campagna pubblicata, candidatura inviata, accordo creato, collaborazione completata, licenza in scadenza. Ogni consegna è firmata (X-ProvenReel-Signature: t=…,v1=…, HMAC-SHA256 di timestamp e corpo con il tuo secret) e ritentata dopo 1, 5, 30, 120 e 720 minuti prima di essere segnata come esaurita. Il registro delle consegne, un ping di prova, la pausa e la rotazione del secret sono nella pagina dei webhook.

I payload contengono solo identificativi, nomi visualizzati e totali concordati.

API di risoluzione del funnel

Per i link sul dominio del brand: il tuo funnel chiama un endpoint di risoluzione firmato per trasformare uno slug personalizzato in un riferimento di attribuzione prima dello store, e segnala le conversioni tramite un feed di eventi firmato. Contratto, intestazioni e rotazione del secret sono nella pagina delle integrazioni.