Уебхукове: известете сайта си, че е продаден билет

Да кажем, че искате броячът на собствения Ви сайт да се премести веднага щом бъде продаден билет. Има два начина да стане това и единият е доста по-добър.

Тази статия обяснява какво е уебхук и дали Ви трябва. Как се настройва, бутон по бутон, ще намерите в Настройване на webhooks.

Обратният свят

Без уебхук сайтът Ви трябва постоянно да пита. Всяка минута, цял ден: „продадено ли е вече нещо?“ Почти винаги отговорът е не. Това са хиляда и четиристотин въпроса на ден, за да чуете три пъти „да“ — а между два въпроса броячът Ви не е верен.

С уебхук обръщате нещата. Давате ни един адрес от собствения си сайт и щом нещо се случи, изпращаме там кратко съобщение. Едно съобщение, в самия момент.

Оттам и името: hook е кука, на която закачаме нещо веднага щом дойде моментът.

Какво можете да правите с него

• броячът на сайта Ви да се мести веднага щом бъде продадено нещо;
• съобщение в екипния чат при всяка поръчка над определена сума;
• да обновявате списъка с членове, когато някой купи годишна карта;
• имейл до себе си, когато поръчка бъде отменена;
• касата или счетоводството Ви веднага да научат, че са постъпили пари.

Какво Ви трябва

Три неща, а Вашият уеб разработчик познава и трите:

1. Адрес на собствения Ви сайт, който може да приема съобщения. Това е обикновена страница, която никой не посещава; тя стои само за да приеме нашето съобщение. Той трябва да започва с https://.
2. Място, където да въведете този адрес. Това правите сами, в Настройки → API достъп, в раздела Webhooks — вижте Настройване на webhooks. Ако уеб разработчикът Ви предпочита да го уреди от собствената си програма, му трябва ключ с правото Уебхукове; вижте Създаване на API ключ.
3. Тайната, която върви с този адрес. Получавате я от нас веднага щом адресът бъде настроен и с нея сайтът Ви проверява, че съобщението наистина идва от нас.

Третото е важно. Без проверка на тайната всеки, който познае адреса Ви, може да убеди сайта Ви, че нещо е продадено. С проверката — не.

Как изглежда

Пристига кратко съобщение, което казва какво се е случило и за какво. Сайтът Ви поглежда тайната, вижда, че съвпада, и след това прави нещо с нея: увеличава брояч, записва ред, изпраща имейл.

Какво точно пише в такова съобщение и как се програмира проверката на тайната, стои в портала за разработчици — това е страницата, която препращате на този, който го изгражда.

Три неща, които често се объркват

Отговаряйте бързо. Нашето съобщение чака отговор най-много десет секунди, а не докато сайтът Ви приключи с всичките си сметки. Приемете съобщението, кажете, че е пристигнало, и свършете работата после.

Разчитайте на повторения. Ако сайтът Ви е бил за кратко недостъпен, опитваме отново — до шест пъти, разпределени в малко повече от ден и половина. Може да се случи едно и също съобщение да пристигне два пъти. Погрижете се сайтът Ви да го понесе — две еднакви съобщения не бива да дават два еднакви имейла.

Пазете тайната в тайна. Мястото ѝ е в настройките на сървъра Ви, а не в код, който стига до публичния сайт.

Трябва ли Ви това?

Не. Уебхукът е полезен, когато нещо трябва да стане веднага. Ако стига дневен преглед, не Ви е нужен — тогава е достатъчно да вземате числата веднъж дневно.

Уебхуковете са в същия план като останалата част от API. Какво влиза в кой план е на страницата с цените на Passavo.

Още за четене

• Настройване на webhooks — самият екран: добавяне на адрес, изпращане на пробно съобщение, четене на дневника на съобщенията.
• Какво е API и нужно ли ми е?
• Създаване на API ключ
• Порталът за разработчици — за този, който изгражда връзката.