- Kategorie
- API
- Směr
- Odesílání událostí
- Formát
- JSON podepsaný pomocí HMAC-SHA256
- Adresy
- Až 25 na organizaci
- Opakování
- Až 6 pokusů, v průběhu více než jednoho dne
- Nastavení
- Adresa HTTPS a tajný klíč
- Tarify
- Tarif Enterprise
- Vydavatel
- Upsellr
01Co webhooky dělají
Signál, který posouvá vaše nástroje vpřed.
- 01
Událost na konci každého zpracování
Dokončeno, neúspěšné nebo zastavené: na konci každého zpracování obohacování nebo generování Upsellr odešle událost s podrobnostmi zpracování.
- 02
Podepsané, aby šlo ověřit
Každé doručení nese identifikátor, časové razítko a podpis HMAC-SHA256 vypočtený vaším tajným klíčem: váš nástroj ověří, že opravdu pochází z Upsellr.
- 03
Opakováno, dokud není přijato
Bez odpovědi 2xx do 10 sekund Upsellr zkusí doručení znovu po 1 minutě, 5 minutách, 30 minutách, 4 hodinách a nakonec po 24 hodinách.
- 04
Záznam každého doručení
Stav, kód HTTP, počet pokusů a obsah: každé doručení si můžete prohlédnout po dobu 7 dní a neúspěšné odeslat znovu jedním kliknutím.
- 05
Propojte své nástroje
Publikujte, upozorněte tým nebo spusťte export, jakmile jsou stránky hotové: webhook dá signál, váš nástroj udělá zbytek.
- 06
Mějte vše pod kontrolou
Deaktivujte adresu, změňte její tajný klíč nebo ji smažte: její čekající opakování se zruší.
02Začínáme
Připojeno za pár minut.
- 01
Otevřete nastavení organizace
Sekce API a webhooky, vyhrazená vlastníkům a administrátorům.
- 02
Přidejte adresu
URL s HTTPS, dostupná z internetu.
- 03
Zkopírujte tajný klíč
Zobrazí se jen jednou a slouží k ověření podpisu každého doručení.
- 04
Ověřte podpis
Znovu vypočtěte podpis HMAC-SHA256 z časového razítka a obsahu a odmítněte příliš staré doručení.
- 05
Odpovídejte rychle
Odpověď 2xx do 10 sekund, zbytek pak zpracujte na své straně.
03Události
Odesílané události.
| Událost | Odesláno | V případě potřeby opakováno |
|---|---|---|
| Zpracování dokončeno (workflow.run.completed) | Ano | Ano |
| Zpracování selhalo (workflow.run.failed) | Ano | Ano |
| Zpracování zastaveno (workflow.run.stopped) | Ano | Ano |
Kompatibilita a požadavky
- Tarif Enterprise
- Veřejná adresa HTTPS na portu 443
- Role vlastníka nebo administrátora
- Odpověď 2xx do 10 sekund
- Tip: deduplikujte podle identifikátoru události
Kontrolu máte vy
Spolehlivé už z principu.
- Podepsané pomocí HMAC-SHA256, s vlastním tajným klíčem pro každou adresu
- Doručené alespoň jednou: deduplikujte podle identifikátoru události
- Opakované až 6krát, v průběhu více než jednoho dne
- Odesílané přes HTTPS, pouze na veřejné adresy
04Otázky
Otázky k webhookům Upsellr.
Jsou webhooky součástí mého tarifu?
Stejně jako API jsou vyhrazeny pro tarif Enterprise.
Jaké události se odesílají?
Konec zpracování obohacování nebo generování: dokončeno, neúspěšné nebo zastavené. Každá událost obsahuje podrobnosti zpracování.
Jak ověřím, že doručení pochází z Upsellr?
Znovu vypočtěte podpis HMAC-SHA256 z časového razítka a obsahu pomocí svého tajného klíče, porovnejte ho s hlavičkou X-Upsellr-Signature a odmítněte doručení starší než 5 minut.
Co se stane, když můj server neodpoví?
Bez odpovědi 2xx do 10 sekund Upsellr zkusí doručení znovu po 1 minutě, 5 minutách, 30 minutách, 4 hodinách a nakonec po 24 hodinách. Neúspěšné doručení lze také odeslat znovu ručně ze záznamu.
Mohu dostat stejnou událost dvakrát?
Ano, je to možné: doručení je zaručeno alespoň jednou, bez zaručeného pořadí. Deduplikujte podle identifikátoru události.
Jak dlouho se záznam uchovává?
7 dní, se stavem, kódem HTTP, počtem pokusů a obsahem každého doručení.
Kolik adres mohu zaregistrovat?
Až 25 na organizaci, každou s vlastním tajným klíčem, který můžete obnovit.
Odešle test v editoru workflow událost?
Ne. Události odesílají jen skutečná zpracování.
Marcus
Amazon