Вебхуки: события на ваш адрес

Без вебхуков узнать о новой брони можно только опросом: дёргать сервер каждую минуту или узнавать новости с опозданием. Вебхук переворачивает это — мы сами сообщаем вам, как только событие произошло.

Что приходит

• booking.created — гость забронировал.
• booking.updated — сменился статус (подтверждена, гость пришёл и так далее).
• booking.cancelled — бронь отменена, время освободилось.
• booking.rescheduled — бронь перенесена на другое время или место.
• resource.changed — место переименовано или снято с продажи.
• venue.updated — изменились название, адрес или ссылка площадки.

Подписка живёт на организации: новые площадки попадают в неё сами. Если нужна одна конкретная — укажите её при создании подписки.

Если адрес или набор событий изменился

Нажмите «Изменить» у подписки и поправьте адрес, события или площадку. Секрет при этом остаётся прежним — переписывать проверку подписи на своей стороне не придётся. Подписку можно и просто выключить: она сохранится вместе с журналом, а события перестанут уходить.

Как убедиться, что запрос от нас

Вместе с подпиской вы получаете секрет — тоже один раз. Каждый запрос мы подписываем им и кладём подпись в заголовок X-Vbazu-Signature. Посчитайте подпись тела своим секретом и сравните: сошлось — запрос наш и не подменён по дороге.

Если ваш сервер не ответил

Мы повторим — несколько раз, с растущими паузами: сначала через полминуты, потом через две, десять, час. Каждая попытка видна в журнале доставок вместе с ответом вашего сервера. Починили приём после того, как попытки кончились — нажмите «Повторить», и мы отправим именно это событие заново.

Ответ, который мы ждём

Любой успешный код — от 200 до 299. Отвечайте сразу, а разбор откладывайте в свою очередь: мы ждём ответа пять секунд, и долгая обработка превратится в неудачную доставку.