Подключение сторонней программы к Link-D

Что это такое и что вам нужно

Link-D — пульт централизованного наблюдения. К нему подключены приборы на объектах: пожарная сигнализация, охрана, датчики. Пульт принимает от них сообщения и показывает диспетчеру.

Эта инструкция — про то, как ваша программа может читать те же данные. Например, чтобы тревоги сами попадали в вашу систему учёта или чтобы объекты отображались на вашей карте.

Что понадобится

Что ключ открывает, а что нет

Куда обращаться

Шаг 1. Проверим, что ключ рабочий

Начните отсюда. Этот запрос ничего не меняет — он спрашивает у пульта: «что за ключ вы мне дали и что он открывает».

Как понять ответ

{
  "вид": "ключ интеграции",
  "название_ключа": "1С заказчика",
  "доступ": "объекты одного заказчика",
  "права": "только чтение",
  "заказчик": "Иванов И. И."
}

Как устроен обмен

Ваша программа сама спрашивает пульт, когда ей нужно. Пульт к вам не стучится — значит вам не нужен ни свой сервер в интернете, ни открытые порты.

Из чего состоит запрос

Адрес плюс ключ в заголовке. Больше ничего.

GET https://адрес-пульта/объекты
Authorization: Bearer linkd_ваш_ключ

Слово Bearer и пробел перед ключом обязательны — так устроен общепринятый способ передачи ключей, и любая библиотека умеет это сама.

Как часто спрашивать

Объекты

Список объектов, доступных вашему ключу. С него обычно начинают: из него берут номера для остальных запросов.

Адрес: GET /объекты

Что в ответе

[
  {
    "номер": 5,
    "номер_объекта": 1,
    "название": "Стенд",
    "адрес": null,
    "активен": true,
    "количество_приборов": 1,
    "приборов_без_связи": 1
  }
]

События

Всё, что приборы прислали на пульт: срабатывания, восстановления, постановки на охрану, тесты связи. События не исчезают и не меняются.

Адрес: GET /события/последние?количество=50

Что в ответе

{
  "id": 7045,
  "recv_time": "2026-09-11 09:34:13.688000+00:00",
  "event_code": "110",
  "qualifier": "1",
  "event_name": "Пожар",
  "category": "Пожар",
  "priority": 1,
  "partition": "01",
  "zone": "055",
  "partition_name": "Дымовой",
  "zone_name": null,
  "dup_count": 1,
  "object_id": 5,
  "object_name": "Стенд"
}

Тревоги

Тревога — не событие, а случай, с которым работает диспетчер. Несколько событий об одном и том же собираются в одну тревогу; у неё есть состояние и время закрытия.

Адрес: GET /инциденты/активные

Что в ответе

{
  "id": 1216,
  "priority": 1,
  "category": "Пожар",
  "title": "Пожар",
  "status": "open",
  "event_count": 2,
  "opened_at": "2026-09-09 07:27:34.944000+00:00",
  "last_event_at": "2026-09-09 07:27:34.944000+00:00",
  "acknowledged_at": null,
  "restored": false,
  "zone_partition": "01",
  "zone_code": "005",
  "object_id": 5,
  "object_name": "Стенд"
}

Ошибки и что делать

Пустой ответ — не ошибка

Пришло [] — значит данных нет: ни активных тревог, ни событий за период. Для пожарного пульта это желаемое состояние.

Безопасность

Как хранить ключ

• Не в коде программы. Код попадает в хранилища версий, копируется, пересылается. Ключ должен лежать в настройках или в переменной окружения.
• Не в переписке. Письмо с ключом останется в почте навсегда — и у вас, и у отправителя, и в резервных копиях почтового сервера.
• Не в мессенджерах и SMS. Сообщение видно на заблокированном экране при доставке и попадает в резервную копию телефона.
• Один ключ — одна программа. Тогда при утечке отзовут ровно её, а остальные интеграции продолжат работать.

Что видно с той стороны

У обслуживающей организации записано, когда ключ выдан, кому, как передан и когда им пользовались в последний раз. Ключ, который год лежит без дела, отзовут и спросят, нужен ли он ещё.

Чего ключ не может в принципе

• Изменить что-либо: тревоги, карточки, настройки — только чтение.
• Увидеть объекты других заказчиков.
• Узнать, как устроен обмен пульта с приборами: пара «порт + номер прибора» наружу не отдаётся никому.
• Войти в кабинет или в пульт — форма входа ключ не принимает.

Программисту

Если вы передаёте эту инструкцию разработчику — вот всё то же самое коротко.

Доступные адреса

Те же данные доступны латинскими адресами — /objects, /events/recent, /incidents/active и так далее — для систем, которые плохо работают с русскими адресами.

Порядок работы

1. При запуске — /объекты, сохранить соответствие номеров своим объектам.
2. Раз в 10–30 секунд — /инциденты/активные, сравнить с прошлым разом: появилось новое — реагировать, пропало — тревогу закрыли.
3. Раз в минуту — /события/последние, брать только те, у которых id больше последнего обработанного.
4. Ошибку 401 считать поводом остановиться и позвать человека, а не поводом повторять запрос в цикле.