Справочник исходящих вебхуков
Исходящие вебхуки позволяют UnSpot уведомлять ваши системы о событиях в реальном времени: UnSpot отправляет HTTP POST с JSON-телом на настроенный вами URL. Типичный сценарий — передача парковочных бронирований в систему СБ или управления шлагбаумом.
Настройка вебхука
Откройте Администрирование > Интеграции > Webhook и создайте вебхук: название, целевой URL, событие и офисы, к которым он относится. Доставляются только события выбранных офисов. Вебхук с одинаковым событием и URL нельзя создать дважды.
События
HTTP-события (тип API):
| Событие | Когда срабатывает |
|---|---|
parking_booking_created | Создано парковочное бронирование |
parking_booking_canceled | Парковочное бронирование отменено или остановлено |
parking_booking_checkin_confirmed | Подтверждён чекин парковочного бронирования |
Дополнительно доступны email-уведомления для: запросов доступа, создания/удаления пользователей, предупреждений о тарифе, системных ошибок синхронизации, истечения аренды пространства и ошибок дисплеев. Они отправляются на email-адреса, а не на URL.
Формат payload
Все парковочные события используют один базовый payload; их различает поле action:
POST <ваш URL>
Content-Type: application/json
{
"fullName": "Анна Иванова",
"email": "anna.ivanova@example.com",
"vehicleNumber": "А123ВС77",
"vehicleModel": "Tesla Model 3",
"start": "2026-07-08T09:00:00+00:00",
"end": "2026-07-08T18:00:00+00:00",
"office": "Штаб-квартира Москва",
"parkingPlace": "P-12",
"action": "Created",
"bookingType": "Parking"
}| Поле | Описание |
|---|---|
action | Created, Canceled / Stopped или Checkin_confirmed |
checkInType | Только для чекин-событий: remote или strict |
start / end | Период бронирования (ISO 8601) |
fullName / email | Владелец бронирования |
vehicleNumber / vehicleModel | Данные автомобиля из бронирования |
office / parkingPlace | Место бронирования |
Доставка, таймауты и повторы
- Запросы отправляются как
POSTсContent-Type: application/jsonи таймаутом 240 секунд. - Для подтверждения доставки ответьте любым статусом 2xx.
- Неудачные доставки увеличивают счётчик ошибок; доставка повторяется очередью. После 100 неудач подряд вебхук переводится в статус
failed, администраторы получают уведомление. Успешная доставка сбрасывает счётчик. - Состояние вебхуков видно в External API > monitoring (категория
webhooks) и на странице интеграций.
Рекомендации по безопасности
- Стандартные запросы вебхуков идут без заголовка аутентификации — относитесь к URL endpoint’а как к секрету: используйте HTTPS и случайный сегмент пути (например,
https://example.com/hooks/unspot-8f3a91). - Валидируйте структуру payload и принимайте только ожидаемые поля.
- Для интеграции Claris UnSpot отправляет собственный
Authorization: Bearerтокен и расширенный payload — включайте опцию Claris только для этой системы.
