Vývojáři

Webhooky

Každé oznámení, které váš účet vygeneruje, lze odeslat přímo do vašich vlastních systémů jako podepsaný JSON POST – takže to, co se děje na vašem hostingu, může spustit pracovní postup kdekoli jinde.

Na co to můžete připojit

Webhook je běžný požadavek HTTPS, takže cokoli, co jej dokáže přijmout, s ním může pracovat. Nemusíte čekat, až pro váš nástroj vytvoříme 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 – odešlete příspěvek do kanálu, otevřete požadavek, aktualizujte tabulku, zavolejte jiné API. Samostatně hostované platformy fungují úplně stejně, pokud je koncový bod dostupný přes HTTPS.

CRM a systémy podpory

Odesílejte fakturační události a události účtu na adresu HubSpot, Pipedrive, Salesforce nebo do libovolného helpdesku či CRM s příchozím webhookem, aby záznam o zákazníkovi odrážel aktuální stav jeho hostingu, aniž by to kdokoli musel ručně kopírovat.

Kdokoli další, kdo naslouchá

Slack, Discord, Google Sheets, Airtable, Notion, vaše vlastní monitoring, datový sklad nebo malý skript, který jste napsali. Pokud dokáže přijmout HTTPS POST a přečíst JSON, může je přijmout.

Co se odesílá

Sami si zvolíte, které kategorie půjdou do kterého cíle – a můžete jich propojit víc, takže fakturace může jít na jedno místo a upozornění na web na jiné. Vše je ve výchozím nastavení zapnuté.

Fakturace a platby

Vydané a zaplacené faktury, neúspěšné platby, karty, jejichž platnost brzy vyprší, 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, obnovení a změny DNS.

Prokázání, že požadavek pochází od nás

Každý požadavek je podepsán tajemstvím, které známe pouze vy a my. Než začnete s tělem pracovat, ověřte podpis – tyto hlavičky přicházejí s každou doručovanou zprávou:

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 podepsané společně s tělem zprávy namísto toho, aby bylo odesláno vedle něj, takže zachycený požadavek nelze později zopakovat proti vám. Odmítněte cokoliv staršího než několik minut.

Podpisový tajný klíč se zobrazí pouze jednou při přidávání webhooku. Nelze jej zobrazit znovu – pokud jej ztratíte, odeberte cíl a přidejte jej znovu.

Nastavení jednoho

  1. Ve svém panelu otevřete Oznámení a přidejte cíl typu Webhook.
  2. Zadejte svůj HTTPS koncový bod a zkopírujte podpisový tajný klíč, který vám zjméníme.
  3. Stiskněte Test. Odešleme skutečný požadavek ve stejném tvaru jako živý, abyste na něj mohli stavět, než se stane něco reálného.
  4. Vyberte, které kategorie má daný cíl dostávat. Nové typy oznámení se zapínají automaticky.

Můžete přidat libovolný počet cílů, kombinovat webhooky s e-maily, Slack a Telegram a každému nastavit jinou sadu kategorií.

Raději byste nám zavolali?

Webhooky vás upozorní, když se něco stane. Pomocí API můžete věci vyvolat – k dispozici máte každou operaci, kterou provádí ovládací panel.

Procházet referenční příručku k rozhraní API