Versions Compared

Version Old Version 3 New Version Current
Changes made by

Inna Kabanova (Unlicensed)

Inna Kabanova (Unlicensed)

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Комплекс —
Note
iconfalse

Комплекс — программно-аппаратный комплекс

EdgeServer

EDGE.
Сервер

—

 — в настоящем документе означает подсистему, реализующую описываемый программный интерфейс комплекса.
Клиент

—

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

—

 — долговременное хранилище событий от множества комплексов.
Пост архива событий

—

 — долговременное хранилище событий от одного комплекса.
Канал поста архива событий

—

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

—

 — запись о происшествии в зоне контроля, которая относится к определенному каналу поста архива событий.
Событие Fact

—

 — факт фиксации проезда транспортного средства через зону контроля.

Доступ к функциям API осуществляется с помощью протокола HTTP. В качестве ответа на запросы клиента могут возвращаться:

  1. данные о структурных компонентах EdgeServer EDGE в формате JSON (в кодировке UTF8UTF-8);

  2. метаданные о событиях в формате JSON (в кодировке UTF8UTF-8);

  3. медиаданные в формате JPEG.

Конкретные адрес и порт для доступа к устройству зависят от настроек EdgeServer EDGE и сети, в которой происходит развертывание.


В запросах все компоненты чувствительны к регистру; порядок параметров (после символа “?”) значения не имеет.

Все запросы должны содержать параметры аутентификации пользователя методом HTTP Basic Authentication.

Обработка запроса не выполняется в случае:

  1. Отсутствия отсутствия параметров аутентификации в запросе. Сервер : сервер возвращает ответ с http HTTP-кодом 404 (NOT FOUND).;

  2. Несовпадения несовпадения параметров аутентификации пользователя. Сервер : сервер возвращает ответ с http HTTP-кодом 401 (UNAUTHORIZED).;

  3. Наличия наличия некорректных параметров в запросе. Сервер : сервер возвращает ответ с http HTTP-кодом 404 (NOT FOUND).;

  4. Внутренней внутренней ошибки сервера при обработке запроса. Сервер : сервер возвращает ответ с http HTTP-кодом 500 (INTERNAL). Рекомендуется сообщить об ; рекомендуется сообщить о такой ошибке разработчику.



Infonote

Ответы сервера могут содержать дополнительные поля, не описанные в настоящем документе. При обработке ответов сервера клиент должен игнорировать такие недокументированные поля.