Vývojáři
Webhooky
Každé oznámení, které Váš účet vygeneruje, může být odesláno přímo do Vašich vlastních systémů jako podepsaný požadavek JSON POST — takže to, co se stane na Vašem hostingu, může spustit pracovní postup kdekoli jinde.
K čemu to můžete připojit
Webhook je běžný požadavek HTTPS, takže cokoli, co jej dokáže přijmout, na něj může reagovat. Nepotřebujete, abychom pro váš nástroj vytvářeli integraci.
Automatizační platformy
Nasměrujte webhook na pracovní postup v n8n, Make, Zapier, Pipedream, Activepieces a každá událost se stane spouštěčem — publikujte v kanálu, otevřete tiket, aktualizujte tabulku, zavolejte jiné API. Samostatně hostované platformy fungují naprosto stejně, pokud je koncový bod dostupný přes HTTPS.
CRM a helpdesky
Odesílejte události týkající se fakturace a účtu do HubSpot, Pipedrive, Salesforce nebo do jakéhokoli helpdesku či CRM s příchozím webhookem, aby záznam zákazníka odrážel stav jeho hostingu, aniž by kdokoli musel data ručně kopírovat.
Cokoli jiného, co naslouchá
Slack, Discord, Google Sheets, Airtable, Notion, vaše vlastní monitorování, datový sklad nebo malý skript, který jste napsali. Pokud dokáže přijmout HTTPS POST a číst JSON, může tyto údaje přijímat.
Co se odesílá
Vy sami si zvolíte, které kategorie směřují do kterého cíle — a můžete jich propojit několik, takže vyúčtování může směřovat na jedno místo a upozornění webu na jiné. Ve výchozím nastavení je vše zapnuto.
Fakturace a platby
Vystavené a zaplacené faktury, neúspěšné platby, karty s blížícím se koncem platnosti, obnovení a zrušení.
Weby a zabezpečení
Zřizování dokončeno, web pozastaven, nalezen malware, zálohy a změny certifikátů.
Podpora a domény
Otevřené a eskalované požadavky, převody domén, prodloužení a změny DNS.
Ověření, že požadavek přišel od nás
Každý požadavek je podepsán tajným klíčem, který znáte pouze Vy a my. Před zpracováním těla zkontrolujte podpis — tyto hlavičky přicházejí s každým doručením:
X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: stable id for this delivery
X-Zinn-Event: invoice.paidČasové razítko je podepsáno společně s tělem zprávy, nikoli posíláno vedle něj, takže požadavek, který někdo zachytil, nelze později vůči Vám znovu přehrát. Odmítněte cokoli staršího než několik minut.
Váš podpisový klíč se zobrazí pouze jednou, a to při přidání webhooku. Znovu jej zobrazit nemůžeme — pokud jej ztratíte, cíl odeberte a znovu přidejte.
Nastavování
- Na svém ovládacím panelu otevřete Oznámení a přidejte cíl typu Webhook.
- Zadejte svůj koncový bod HTTPS a zkopírujte tajný klíč pro podepisování, který vám zobrazíme.
- Stiskněte Test. Odešleme skutečný požadavek ve stejné podobě jako živý, abyste na něm mohli stavět ještě předtím, než dojde k něčemu skutečnému.
- Vyberte, které kategorie má tento cíl přijímat. Nové typy oznámení se zapínají automaticky.
Můžete přidat libovolný počet cílů, kombinovat webhooky s e-mailem, službami Slack a Telegram a každému přiřadit jinou sadu kategorií.
Dáváte přednost telefonickému kontaktu?
Webhooky vás informují, když k něčemu došlo. API představuje způsob, jak něco uskutečnit — každá operace, kterou ovládací panel provádí, je vám k dispozici.