Trassir MiniNVR и API: примеры использования SDK для автоматизации задач

Trassir MiniNVR и API: примеры использования SDK для автоматизации задач

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

Почему это важно

У вас может быть много камер, датчиков и устройств. Ручная настройка и постоянный мониторинг утомительны. API позволяет сделать сценарии: запись по таймеру, уведомления в мессенджер, передача тревоги в ACS, автоматический бэкап ключевых фрагментов.

Коротко о том, как это работает

Технически Trassir MiniNVR предоставляет набор интерфейсов:

• сетевые протоколы для видеопотока — RTSP/ONVIF;
• внешний API/SDK для управления, получения метаданных и событий;
• возможность webhook или TCP-подписки на события (движение, вход на территорию, разрыв потока).

Схема типовой интеграции: устройство/камера → MiniNVR (запись + аналитика) → ваш сервис (через API) → конечные действия (уведомление, управление реле, архив).

Типовые сценарии применения

• Малый магазин: при срабатывании детектора движения — сохранить 30 с записи и отправить ссылку менеджеру.
• Офис: при проходе сотрудника через контроллер — автоматически привязать видеофрагмент к событию доступа.
• Домашняя система: при тревоге от датчика дыма — включить камеру в режим усиленной записи и оповестить владельца.
• Инсталляторы: централизованное обновление прошивок и мониторинг состояния всех MiniNVR в сети.

Примеры кода (упрощённо)

Ниже примеры-образцы. В реальной системе проверьте документацию вашей версии SDK и настройте безопасную аутентификацию.

1. Получение списка камер и включение записи (Python + requests)

import requests
base = "http://MININVR_IP/api"
token = requests.post(base + "/login", json={"user":"admin","pass":"***"}).json()["token"]
headers = {"Authorization": "Bearer " + token}

cams = requests.get(base + "/cameras", headers=headers).json()
for c in cams:
    if c["name"].startswith("Вход"):
        requests.post(base + f"/cameras/{c['id']}/start_record", headers=headers)

2. Подписка на события через webhook

# В MiniNVR настроить webhook: http(s)://your-server/trassir_event
# На вашем сервере принимать POST и сохранять фрагмент архива
# Пример логики:
# если событие.type == "motion" и zone == "витрина" -> запросить экспорт 30s видео

3. Экспорт архива за указанный промежуток

resp = requests.post(base + "/archive/export",
                       headers=headers,
                       json={"camera_id": 5, "from": "2026-02-01T12:00:00",
                             "to": "2026-02-01T12:00:30"})
# ссылка на файл в ответе -> скачать

Интеграция с остальными системами

MiniNVR хорошо сочетается с контроллерами доступа, охранными панелями и SCADA. Практические советы:

• Идентифицируйте события с уникальными ID и привязывайте видеофрагменты по времени.
• Используйте отдельного пользователя API с ограниченными правами для внешних сервисов.
• Если нужно мгновенное оповещение — используйте WebSocket/Push вместо периодических опросов.

Настройка MiniNVR: пошагово

• Подключите питание и сеть.
• Зайдите в веб-интерфейс по IP, обновите прошивку.
• Добавьте камеры через ONVIF/RTSP, проверьте запись.
• Создайте пользователя API и настройте ключ/токен.
• Включите события: motion, tamper, loss и привяжите webhook/уровни тревоги.
• Настройте архивирование и ротацию диска.

Безопасность и соответствие закону

Важно хранить персональные данные корректно. В России нужно учитывать 152-ФЗ (персональные данные). Краткие рекомендации:

• Шифруйте трафик API (HTTPS).
• Сильные пароли и двухфакторная аутентификация для админов.
• Логи доступа и событий — для разбирательств.
• Информируйте людей о видеозаписи, если это требуется локальными правилами.

Сравнение: MiniNVR vs сервер vs облако

Примерный бюджет

• MiniNVR (устройство) — зависит от модели: от бюджетных до PRO.
• Камеры — от 2–3 тыс. руб. до профессиональных 50+ тыс.
• Интеграция/скрипты — от 5 тыс. руб. для простого webhook до десятков тысяч для сложной системы.

Чек‑лист перед внедрением

• Определите сценарии автоматизации и события.
• Проверьте версию прошивки и документацию API для вашей модели MiniNVR.
• Настройте сеть и HTTPS.
• Создайте отдельного API-пользователя с минимальными правами.
• Тестируйте экспорт архива и восстановление файлов.
• Настройте резервное копирование конфигурации и архива.

Если вы выбираете оборудование и инсталлятора, смотрите предложения по системам видеонаблюдения — там можно подобрать MiniNVR, камеры и сервис установки.

Небольшая ремарка: документация и возможности API могут отличаться по версиям. Если нужен конкретный пример для вашей модели MiniNVR (файлы SDK, конкретные эндпойнты или готовые скрипты) — можно подготовить практический набор скриптов и пошаговую настройку под вашу сеть.