Що таке API та SDK і навіщо вони потрібні

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

Що таке API

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

Простіше кажучи, API відповідає на три питання:

1. Які операції доступні
   ​Наприклад: отримати список камер, запитати архів, змінити параметри користувача, отримати подію тривоги тощо.
2. Який формат запитів і відповідей
   ​URI, структура JSON/XML, коди помилок, параметри авторизації.
3. У яких сценаріях можна використовувати інтерфейс
   Інтеграція із зовнішніми системами, автоматизація процесів, побудова власних сервісів.

В екосистемі систем безпеки це, як правило, 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

API Hikvision

ISAPI (Intelligent Security API)

• Прикладний протокол на базі HTTP у REST-подібному стилі.
• Використовується для зв’язку між пристроями (камери, DVR/NVR тощо) і клієнтським/серверним ПЗ.
• Охоплює керування пристроєм, отримання відео/метаданих, подій, конфігурації тощо.

OpenAPI зі сторони HikCentral

У серверної платформи HikCentral Professional є власний OpenAPI (REST-інтерфейс), який використовується для інтеграції платформи із зовнішніми системами (ІСУП, СКД, ERP тощо).

Для чого бізнесу потрібні API та SDK

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

Основні сценарії:

Інтеграція систем

• Відеоспостереження з СКД (події проходу, відеопідтвердження).
• Система безпеки + облік робочого часу.
• HikCentral / NVR + корпоративні портали, BI-системи, CRM тощо.

Автоматизація

• Автоматичне створення/видалення користувачів за даними з AD/HR.
• Сценарії при тривожних подіях (сповіщення, блокування, запис інциденту).
• Обмін подіями та статусами з іншими ІТ-системами.

Власні інтерфейси та сервіси

• Єдине робоче місце оператора безпеки.
• Спеціалізовані панелі моніторингу.
• Мобільні застосунки, кастомізовані під задачі замовника.

Розширення можливостей існуючих рішень

• Додавання власної логіки поверх стандартного ПЗ.
• Інтеграція з галузевими системами (транспорт, рітейл, промисловість тощо).

Роль нашої компанії: що саме ми робимо

Ключовий момент, який важливо підкреслити:
Ми не займаємося розробкою програмного забезпечення і не пишемо інтеграційний код.

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

Надаємо документацію по API

• ISAPI Developer Guides і профільні посібники (відео, ANPR, доступ тощо).
• Відомості щодо сумісності пристроїв з ONVIF згідно з офіційними даташитами.
• Керівництва по OpenAPI HikCentral (за наявності та в рамках доступних версій).

А також: Device Network SDK (Win/Linux) з Developer Guide і демо.
WebSDK. Вони також доступні у відкритому доступі:
https://www.hikvision.com/us-en/support/download/sdk/

Для надання актуальної інформації щодо доступних API та SDK необхідно уточнити параметри вашого обладнання. Будь ласка, надайте:

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

При цьому:

• написання коду, тестування та супровід інтеграції виконують або ваші внутрішні розробники, або обраний вами інтегратор;
• ми не входимо до кола розробки і не беремо на себе відповідальність за архітектуру та якість реалізованого програмного рішення.

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