Trassir DuoStation SDK и API: примеры интеграции и автоматизации

Trassir DuoStation SDK и API: примеры интеграции и автоматизации

Trassir — одна из популярных систем видеонаблюдения в России. DuoStation — часть экосистемы Trassir: клиентские и серверные компоненты, SDK и API для интеграторов. В этой статье объясню, как подступиться к интеграции, какие бывают сценарии автоматизации, какие интерфейсы использовать, приведу простые схемы, примеры запросов и чек‑лист для выбора решения. Подойдёт и новичку, и инсталлятору.

Зачем нужен SDK/API Trassir и где он применим

API позволяет связать систему видеонаблюдения с другими сервисами: контроль доступа, охрана, учёт посетителей, аналитика. SDK даёт библиотеку и примеры, ускоряющие разработку: подключение к видео, подписка на события (движение, детекция лица, пересечение линии), управление PTZ, поиск по архиву и выгрузка метаданных.

API — это способ, которым ваши устройства и сервисы договариваются друг с другом. С ним можно не только смотреть видео, но и строить автоматические сценарии.

Какие интерфейсы доступны (обзор)

В составе Trassir обычно доступны несколько способов интеграции:

• RTSP — потоковое видео в реальном времени (подходит для трансляций и аналитики).
• ONVIF — стандартный интерфейс для управления камерами и получения потока.
• HTTP/REST API — для работы с событиями, пользователями, архивом, метаданными.
• WebSocket/Long Polling — для подписки на события в реальном времени.
• Нативный SDK (C++, C#, Python) — обёртки и примеры для глубокой интеграции.

Типовые сценарии и схемы интеграции

Вот три практических сценария, которые встречаются часто.

1. Интеграция с системой контроля доступа.
Камера отправляет событие распознавания лица → API Trassir посылает событие в контроллер СКУД → дверь открывается при совпадении. Для этого используйте REST-запросы событий или WebSocket-подписку.

2. Массовая аналитика и учёт посетителей.
Сервер Trassir отсылает метаданные о пересечении линии и тепловые карты в аналитическую платформу. Метаданные передаются в JSON по HTTPS или сохраняются в формате CSV для дальнейшей обработки.

3. Автоматический мониторинг и оповещение.
При детекции движения ночью система запускает запись, делает скриншот и отправляет уведомление в Telegram/SMB. Это делается через HTTP-вызов и cron/триггеры в SDK.

Пример потоковой схемы (упрощённо)

Камера → Trassir Server (обработка, аналитика) → REST API/WebSocket → Внешний сервис (СКУД, уведомления, BI)

Практические примеры запросов

Ниже — упрощённые примеры. В реальной системе оформляйте авторизацию, TLS и обработку ошибок.

GET /api/v2/cameras
Host: trassir-server
Authorization: Bearer <token>

Подписка на события (WebSocket):

ws://trassir-server/events?token=<token>
{"type":"subscribe","events":["motion","face_recognition"]}

Получение архива по таймкоду (псевдокод):

POST /api/v2/archive/search
{"camera_id":"123","from":"2026-02-01T08:00:00Z","to":"2026-02-01T09:00:00Z"}

Эти примеры демонстрируют принцип. В SDK есть готовые функции для авторизации, повторных подключений, парсинга метаданных.

Сравнение подходов: какие интерфейсы выбрать

Размеры системы и расчёт хранилища

Простой расчёт: Storage(ГБ) = Количество камер × FPS × часа в сутки × дней хранения × средний битрейт(Мбит/с) / 8 / 1024.

Пример: 10 камер × 15 FPS × 24 часа × 30 дней × 4 Мбит/с → ≈ 5 000 ГБ.

Безопасность и соответствие требованиям

• Шифрование каналов: включайте TLS для REST/WebSocket и HTTPS для выгрузок.
• Права доступа: разделяйте роли (чтение видео, управление, админ).
• Хранение и удаление: настройте сроки хранения в соответствии с политикой заказчика и локальными требо-ваниями о персональных данных.
• Логи и аудита: включите логирование доступа к видео и API-запросам.

Пример пошаговой интеграции (шаблон для проекта)

1. Определите сценарии: какие события, кто будет подписчиком, частота обращений.
2. Выберите интерфейс: RTSP для потоков, REST/WebSocket для событий, SDK для глубокой интеграции.
3. Разверните тестовый сервер Trassir и получите тестовый токен/ключ.
4. Реализуйте авторизацию и минимальную обработку событий (дебаг в логах).
5. Тестируйте отказоустойчивость: перезапуски, потерю сети, перегрузки.
6. Внедрите мониторинг и алерты на ошибки интеграции.

Цены и лицензирование — что важно знать

Лицензии Trassir обычно зависят от числа каналов, набора аналитики и модулей. SDK и интеграционные модули могут быть платными или включаться в пакет. Стоимость варьируется: для маленького проекта это может быть несколько десятков тысяч рублей, для крупных инсталляций — сотни тысяч. Точные условия лучше уточнять у официальных партнёров и поставщиков.

Чек‑лист перед запуском

• Определены сценарии и интерфейсы.
• Есть тестовый сервер и доступы API.
• Реализована авторизация и шифрование.
• Проведены нагрузочные тесты и расчёт хранилища.
• Настроено логирование и мониторинг.
• Оформлены договоры и политика хранения персональных данных.

Где купить оборудование и заказать монтаж

Если хотите подобрать камеры, серверы и услуги монтажа под интеграцию с Trassir, смотрите каталог систем видеонаблюдения на сайте поставщика.

https://y-ss.ru/catalog/sistemy_videonablyudeniya/

Коротко о главном

Trassir DuoStation и его SDK/API дают все базовые инструменты для интеграции видеонаблюдения с бизнес‑процессами. Сначала определите сценарии, выберите интерфейс (RTSP/ONVIF/REST/SDK), протестируйте на стенде и позаботьтесь о безопасности и хранении данных. Правильная архитектура и контроль качества работы системы сэкономят бюджет и снизят количество аварий на рабочем проекте.

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