Отправка WebHook (POST-запрос по указанному URL)
Справочник событий - Webhook
В событии можно настроить действие при срабатывании - отправка Webhook.
В качестве параметра действия указывается URL, который будет вызван. URL должен быть полным, начинаться с http:// или https://
При срабатывании события будет произведен POST-запрос по указанному URL. Если запрос прерывается по таймауту или завершается с ошибкой, будет произведено до 3 повторных вызовов.
В качестве тела будет передан json-объект с данными о событии.
Пример тела запроса:
{
"type": 1,
"alarmId": 1238034,
"timeUtc": "2025-11-14T07:32:43",
"timeLocal": "2025-11-14T07:32:43",
"objectId": 3872,
"objectName": "Н337КВ19",
"entityType": 2,
"entityId": 106,
"entityName": "скорость",
"eventId": 278,
"eventName": "Превышение скорости",
"alarmText": "скорость>40",
"priority": 4,
"limit": "40",
"entityValue": "81",
"lat": 55.943716,
"lon": 94.747736,
"address": "04К-769, Заозёрный, Красноярский край, Россия",
"driverName": "",
"geofenceName": ""
}Описание полей:
|
Поле |
Тип |
Описание |
Примечание |
|
type |
enum |
Тип json-объекта |
На текущий момент только один тип = 1 - сработка события |
|
alarmId |
ulong |
Id сработки события |
Уникальный на уровне всего сервера |
|
timeUtc |
DateTime |
Время начала сработки события, UTC |
Формат: yyyy-MM-ddTHH:mm:ss |
|
timeLocal |
DateTime |
Время начала сработки события, в часовом поясе, указанном в настройках компании (той, к которой принадлежит объект) |
Формат: yyyy-MM-ddTHH:mm:ss |
|
objectId |
ulong |
Id объекта, по которому сработало событие |
Уникальный на уровне всего сервера |
|
objectName |
string |
Имя объекта |
|
|
entityType |
enum |
Тип сущности, по которой была сработка события (т.е. куда событие было назначено) |
Значения:
|
|
entityId |
ulong |
Id сущности, по которой была сработка события |
Уникальный на уровне всего сервера |
|
entityName |
string |
Имя сущности, по которой была сработка события |
|
|
eventId |
ulong |
Id события (из справочника событий) |
Уникальный на уровне всего сервера |
|
entityName |
string |
Имя события (из справочника событий) |
|
|
alarmText |
string |
Текст события (с заполненными значениями макросов, если они есть) |
|
|
priority |
enum |
Критичность события |
Значения:
|
|
limit |
string |
Порог сработки события |
Обычно это число, но для разных типов сущности теоретически может быть не числовым значением |
|
entityValue |
string |
Значение. которое вызвало сработку события |
Обычно это число, но для разных типов сущности теоретически может быть не числовым значением |
|
lat |
double |
Широта |
Текущее местоположение объекта |
|
lon |
double |
Долгота |
Текущее местоположение объекта |
|
address |
string |
Адрес |
Определяется на основе широты и долготы |
|
driverName |
string |
Имя водителя (из справочника водителей) |
Определяется по датчику RFID или через справочник назначений |
|
geofenceName |
string |
Имя геозоны, из которой выехали или в которую въехали |
Заполняется только для сущности с типом "Контроль геозон" |