Web-hooks (вебхуки)

Web-hooks - механізм, що дає змогу отримувати дані про нові записи в Хорошопі під час спрацьовування подій на сайті (наприклад Оформлення замовлення).

Зручно використовувати для того, щоб знизити навантаження на сервер, на якому розташовано сайт, і виключити необхідність часто здійснювати запити на вивантаження нових даних (які могли навіть не оновитися) з сайту, таких як:

  • Оформлення замовлення
  • Реєстрація користувача
  • Запит зворотнього дзвінку

Після підписки на події система під час спрацьовування події створює чергу на відправлення даних за посиланнями передплатників подій. У разі якщо запит за посиланням передплатника повернув HTTP код відмінний від кодів 20х (200, 201...), то Хорошоп через деякий час (приблизно 10 хвилин) спробує надіслати дані за посиланням передплатника ще раз (максимум 10 разів).


Важливо

Чергу за хуками відправляє планувальник завдань (cron) раз на 5 хвилин, тому можливі затримки в надсиланні даних.

Це зроблено для уникнення блокування інтерфейсу користувача під час роботи з сайтом.


Якщо в Хорошопі видалити передплатника на розсилку вручну (доступно розробникам), то Хорошоп автоматично надішле запит методом DELETE за посиланням, зазначеним у процесі підписки на хук, що означатиме, що в системі передплатник більше не зареєстрований.

Рекомендується розробникам, які розробляють інтеграцію з Хорошопом, додати у себе обробку HTTP методу DELETE.


Детальніше: