API klíče a webhooky

API klíče a webhooky spravuje vlastník nebo admin v „Nastavení“ → „Integrace“.

API klíč

1. Otevřete „API klíče“ a klikněte na „Vytvořit klíč“. Vyplňte „Název“ a „Oprávnění“ („Čtení“, „Zápis“).
2. Klíč začínající tklfy_ hned zkopírujte, znovu ho nezobrazíme. Potvrďte „Mám uloženo“.
3. Posílejte ho v hlavičce Authorization: Bearer nebo x-api-key na https://api.tiklify.com/v1/api/. Limit je 60 požadavků za minutu.

Ztracený klíč odvolejte („Odvolat“) a vytvořte nový.

Webhook

1. Otevřete „Webhooky“ a klikněte na „Vytvořit webhook“.
2. V poli „Verze událostí“ nechte verzi 2 pro aktuální kampaně: posílá campaign_target.status_changed a campaign.terminal.
3. Zadejte „URL endpointu (HTTPS)“ (veřejná adresa, ne IP adresa, bez jména a hesla) a vyberte „Události“.
4. Zkopírujte „Podpisový klíč“; po zavření ho už neuvidíte.
5. Pošlete „Test“ a výsledek zkontrolujte v sekci „Poslední doručení“.

Podpis. Hlavička Tiklify-Signature má tvar t=…,v1=…. Hodnota v1 je HMAC-SHA256 (hex) vašeho podpisového klíče z textu, který vznikne spojením časového razítka t, tečky a těla požadavku. Událost popisují i hlavičky Tiklify-Event a Tiklify-Event-Id.

Doručení. Endpoint musí do 10 sekund odpovědět kódem 2xx; přesměrování nesledujeme. Každé doručení zkusíme nejvýše 5krát, s rostoucím odstupem od 30 sekund. Po 5 neúspěšných doručeních po sobě webhook vypneme a pošleme upozornění.

Nepomohlo? Napište nám na hello@tiklify.com.