Что такое API и SDK и зачем они нужны

В современных системах безопасности и видеонаблюдения ключевая задача — не только “снимать видео”, но и интегрироваться с другими ИТ-системами: СКУД, ERP, HR, биллингом, BI-аналитикой и т.д. Для этого используются два базовых инструмента: API и SDK.

Что такое API

API (Application Programming Interface) — это формально описанный интерфейс, через который одна программа может управлять другой или обмениваться с ней данными.

Проще говоря, API отвечает на три вопроса:

• Какие операции доступны
  Например: получить список камер, запросить архив, изменить параметры пользователя, получить событие тревоги и т.д.

• Какой формат запросов и ответов
  URI, структура JSON/XML, коды ошибок, параметры авторизации.

• В каких сценариях интерфейс можно использовать
  Интеграция с внешними системами, автоматизация процессов, построение собственных сервисов.

В экосистеме систем безопасности это, как правило, HTTP/REST-интерфейсы, либо стандартные протоколы вроде ONVIF.

Что такое SDK

SDK (Software Development Kit) — это набор инструментов для разработчиков, который упрощает работу с API и/или внутренними протоколами оборудования.

Обычно SDK включает:

• библиотеки (DLL/so) и заголовочные файлы для C/C++/C#/Java и пр.;

• примеры кода;

• руководство разработчика;

• инструкции по настройке среды разработки и типовые схемы интеграции.

Если API — это язык общения, то SDK — это готовый “набор фраз и шаблонов”, позволяющий быстро, безопасно и одинаково корректно этим языком пользоваться.

Разница между API и SDK

• API задаёт правила взаимодействия и перечень возможностей.

• SDK предоставляет готовые инструменты, чтобы разработчику не приходилось всё реализовывать с нуля.
   

Часто SDK просто “оборачивает” API или внутренний протокол оборудования, добавляя обработку ошибок, авторизацию, очереди, кэш и т.п.

Как это устроено у Hikvision:

У Hikvision официально доступны и API, и SDK, причём в нескольких вариантах.

API Hikvision

1. ISAPI (Intelligent Security API)

Прикладной протокол на базе HTTP в REST-подобном стиле.

Используется для связи между устройствами (камеры, DVR/NVR и др.) и клиентским/серверным ПО.

Охватывает управление устройством, получение видео/метаданных, событий, конфигурации и т.д.

2. OpenAPI со стороны HikCentral

У серверной платформы HikCentral Professional есть собственный OpenAPI (REST-интерфейс), который используется для интеграции платформы с внешними системами (ИСУЧ, СКУД, ERP и т.д.)

Для чего бизнесу нужны API и SDK

API и SDK позволяют не ограничиваться “из коробки” функционалом, а интегрировать системы безопасности в конкретные бизнес-процессы.

Основные сценарии:

1. Интеграция систем

Видеонаблюдение с СКУД (события прохода, видеоподтверждение).

Система безопасности + учёт рабочего времени.

HikCentral / NVR + корпоративные порталы, BI-системы, CRM и др.

2. Автоматизация

Автоматическое создание/удаление пользователей по данным из AD/HR.

Сценарии при тревожных событиях (уведомления, блокировки, запись инцидента).

Обмен событиями и статусами с другими ИТ-системами.

3. Собственные интерфейсы и сервисы

Единое рабочее место оператора безопасности.

Специализированные панели мониторинга.

Мобильные приложения, кастомизированные под задачи заказчика.

4. Расширение возможностей существующих решений

Добавление собственной логики поверх стандартного ПО.

Интеграция с отраслевыми системами (транспорт, ритейл, промышленность и др.).

Роль нашей компании: что именно мы делаем

Ключевой момент, который важно подчеркнуть:

Мы не занимаемся разработкой программного обеспечения и не пишем интеграционный код.

Наша роль — поставщик официальных материалов для ваших разработчиков или интеграторов.
 

Предоставляем документацию по API
 

1. ISAPI Developer Guides и профильные руководства (видео, ANPR, доступ и т.п.);

2. сведения по ONVIF-совместимости устройств согласно их официальным даташитам;

3. руководства по OpenAPI HikCentral (при наличии и в рамках доступных версий).
    

А так же: Device Network SDK (Win/Linux) с Developer Guide и демо.

WebSDK. Они так же доступны в общем доступе: https://www.hikvision.com/us-en/support/download/sdk/ 

Для предоставления актуальной информации по доступным API и SDK требуется уточнить параметры вашего оборудования. Пожалуйста, предоставьте:

1. Полную модель устройства (например: DS-2CD2T46G2-ISU/SL).

2. Серийный номер устройства.

При этом:

• написание кода, тестирование и сопровождение интеграции выполняют либо ваши внутренние разработчики, либо выбранный вами интегратор;

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

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

Обратитесь к нам, и мы поможем вам начать интеграцию на прочном и надёжном технологическом фундаменте.