Програмери

Веб-куке

Свако обавештење које Ваш налог генерише може бити послато директно на Ваше сопствене системе као потписан JSON POST — тако да оно што се дешава на Вашем хостингу може покренути радни ток било где другде.

Сва документација за програмере →

Zinn®, наш Викинг, кује на свом наковњу поред API крајње тачке која шаље догађаје неколицини слушалаца.

Са чиме можете да га повежете

Вебхук је обичан HTTPS захтев, тако да све што може да га прими може и да поступи по њему. Није Вам потребно да ми изградимо интеграцију за Вашу алатку.

Платформе за аутоматизацију

Усмерите веб-куку ка току посла у n8n, Make, Zapier, Pipedream, Activepieces и сваки догађај постаје окидач — објавите на каналу, отворите тикет, ажурирајте табелу, позовите други API. Самостално хостоване платформе раде на потпуно исти начин, све док је крајња тачка доступна преко HTTPS-а.

CRM системи и центри за подршку

Шаљите догађаје везане за наплату и налог сервису HubSpot, Pipedrive, Salesforce или било ком сервису за корисничку подршку или CRM систему са долазним веб-хуком, како би подаци о кориснику одражавали шта се дешава са њиховим хостингом без потребе да ико то ручно преноси.

Било шта друго што ослушкује

Slack, Discord, Google Sheets, Airtable, Notion, сопствени систем за праћење, складиште података или кратка скрипта коју сте написали. Ако може да прихвати HTTPS POST и чита JSON, може и да прима ово.

Шта се шаље

Ви бирате које категорије иду на које одредиште — и можете повезати неколико њих, тако да наплата може ићи на једно место, а обавештења о сајту на друго. Све је подразумевано укључено.

Фактурисање и плаћања

Издате и плаћене фактуре, неуспела плаћања, картице које ускоро истичу, обнове и отказивања.

Сајтови и безбедност

Обезбеђивање ресурса је завршено, сајт је суспендован, пронађен је злонамерни софтвер, резервне копије и промене сертификата.

Подршка и домени

Отворени и ескалирани тикети, трансфери домена, обнове и измене DNS-а.

Доказивање да је захтев стигао од нас

Сваки захтев је потписан тајним кључем који поседујемо само ви и ми. Проверите потпис пре него што поступите по телу поруке — ова заглавља стижу са сваком испоруком:

X-Zinn-Signature: sha256=<hmac of `timestamp.body`>
X-Zinn-Timestamp: unix seconds
X-Zinn-Delivery: unique per delivery; the same on every retry of it
X-Zinn-Event: invoice.paid

Временска ознака је потписана заједно са телом уместо да се шаље поред њега, тако да захтев који је неко пресрео не може касније поново да се пошаље ка вама. Одбијте све што је старије од неколико минута.

Заглавље X-Zinn-Delivery је јединствено за сваку испоруку: сваки догађај и сваки притисак на „Тестирај” добија сопствено. Ако ваша крајња тачка не одговори статусом 2xx, исту испоруку шаљемо поново након 1, 5, 25, 125 и 625 минута, са истим X-Zinn-Delivery заглављем и новим временским жигом и потписом. Задржите ID-ове које сте већ обрадили и занемарите понављања.

Ваша контролна табла наводи сваку испоруку под њеним одредиштем на екрану „Обавештења” током 30 дана: када је послата, колико је покушаја било потребно и шта је ваша крајња тачка одговорила.

Ваш тајни кључ за потписивање се приказује само једном, када додате веб-хук. Не можемо га поново приказати — ако га изгубите, уклоните одредиште и додајте га поново.

Подешавање

  1. На својој контролној табли отворите Обавештења и додајте одредиште типа Webhook.
  2. Унесите своју HTTPS крајњу тачку и копирајте тајни кључ за потписивање који вам приказујемо.
  3. Притисните „Test“. Шаљемо прави захтев истог облика као онај уживо, тако да можете да развијате у односу на њега пре него што се ишта стварно деси.
  4. Изаберите које категорије то одредиште треба да прима. Нове врсте обавештења се аутоматски укључују.

Можете додати онолико одредишта колико желите, комбиновати веб-хукове са имејлом, Slack-ом и Telegram-ом, и сваком од њих доделити различит скуп категорија.

Више бисте волели да нас позовете?

Веб-куке вас обавештавају када се нешто десило. АПИ је начин на који чините да се нешто догоди — свака операција коју контролна табла обавља доступна вам је.

Прегледајте API референцу