ГОСТ Р 72030.3-2026. Национальный стандарт Российской Федерации. Умный город. Системы фотовидеофиксации в сфере городского управления, работающие в автоматическом режиме. Часть 3. Прикладной программный интерфейс
Актуально на 03.11.2026.
Как цитировать: "ГОСТ Р 72030.3-2026. Национальный стандарт Российской Федерации. Умный город. Системы фотовидеофиксации в сфере городского управления, работающие в автоматическом режиме. Часть 3. Прикладной программный интерфейс". ГОСТ Р 72030.3-2026. https://bukva.ai/docs/standart-gost-r-72030-3-2026
(утв. и введен в действие Приказом Росстандарта от 21.01.2026 № 19-ст)
Примечание
Документ введен в действие с 30.06.2026.
Утвержден и введен в действие Приказом Федерального агентства
по техническому регулированию
и метрологии
от 21 января 2026 г. № 19-ст
СИСТЕМЫ ФОТОВИДЕОФИКСАЦИИ В СФЕРЕ ГОРОДСКОГО УПРАВЛЕНИЯ, РАБОТАЮЩИЕ В АВТОМАТИЧЕСКОМ РЕЖИМЕ
ПРИКЛАДНОЙ ПРОГРАММНЫЙ ИНТЕРФЕЙС
Smart city. Photo and video recording systems in the field
of urban management, operating in automatic mode. Part 3.
Application programming interface
Дата введения 30 июня 2026 года
Предисловие
1 РАЗРАБОТАН Федеральным государственным бюджетным учреждением «Российский институт стандартизации» (ФГБУ «Институт стандартизации») и Некоммерческим партнерством «Русское общество содействия развитию биометрических технологий, систем и коммуникаций» (Некоммерческое партнерство «Русское биометрическое общество»)
2 ВНЕСЕН Техническим комитетом по стандартизации ТК 194 «Кибер-физические системы»
3 УТВЕРЖДЕН И ВВЕДЕН В ДЕЙСТВИЕ Приказом Федерального агентства по техническому регулированию и метрологии от 21 января 2026 г. № 19-ст
Правила применения настоящего стандарта установлены в статье 26 Федерального закона от 29 июня 2015 г. № 162-ФЗ «О стандартизации в Российской Федерации». Информация об изменениях к настоящему стандарту публикуется в ежегодном (по состоянию на 1 января текущего года) информационном указателе «Национальные стандарты», а официальный текст изменений и поправок — в ежемесячном информационном указателе «Национальные стандарты». В случае пересмотра (замены) или отмены настоящего стандарта соответствующее уведомление будет опубликовано в ближайшем выпуске ежемесячного информационного указателя «Национальные стандарты». Соответствующая информация, уведомление и тексты размещаются также в информационной системе общего пользования — на официальном сайте Федерального агентства по техническому регулированию и метрологии в сети Интернет (www.rst.gov.ru)
1 Область применения
Настоящий стандарт устанавливает требования к прикладному программному интерфейсу (API) интеграции с системами фотовидеофиксации в сфере городского управления, работающими в автоматическом режиме (СФВФ), для получения информации о событиях в сфере городского хозяйства, зафиксированных с помощью средств фотовидеофиксации СФВФ.
В настоящем стандарте API определен на основе парадигмы REST.
2 Нормативные ссылки
В настоящем стандарте использована нормативная ссылка на следующий стандарт:
ГОСТ Р 72030.1 Умный город. Системы фотовидеофиксации в сфере городского управления, работающие в автоматическом режиме. Часть 1. Общие требования
Примечание - При пользовании настоящим стандартом целесообразно проверить действие ссылочных стандартов в информационной системе общего пользования — на официальном сайте Федерального агентства по техническому регулированию и метрологии в сети Интернет или по ежегодному информационному указателю «Национальные стандарты», который опубликован по состоянию на 1 января текущего года, и по выпускам ежемесячного информационного указателя «Национальные стандарты» за текущий год. Если заменен ссылочный стандарт, на который дана недатированная ссылка, то рекомендуется использовать действующую версию этого стандарта с учетом всех внесенных в данную версию изменений. Если изменен ссылочный стандарт, на который дана датированная ссылка, то рекомендуется использовать версию этого стандарта с указанным выше годом утверждения (принятия). Если после утверждения настоящего стандарта в ссылочный стандарт, на который дана датированная ссылка, внесено изменение, затрагивающее положение, на которое дана ссылка, то это положение рекомендуется применять без учета данного изменения. Если ссылочный стандарт отменен без замены, то положение, в котором дана ссылка на него, рекомендуется применять в части, не затрагивающей эту ссылку.
3 Термины и определения
В настоящем стандарте применены термины по ГОСТ Р 72030.1.
4 Общая концепция программных интерфейсов интеграции с системами фотовидеофиксации в сфере городского управления, работающими в автоматическом режиме
Тела запросов используются для передачи на сервер данных ресурсов, которые необходимо создать или обновить, а тела ответов — сервером для возврата состояний ресурсов или результата операций над ресурсами.
В программных интерфейсах интеграции с СФВФ, описываемых в настоящем стандарте, для передачи данных использованы следующие методы из протоколов HTTPS:
- GET для получения информации о ресурсе и запроса представления указанного ресурса. В методе GET тело запроса отсутствует, но есть тело ответа, которое описывает состояние извлеченного ресурса;
- POST для создания нового ресурса и (или) отправки данных. В методе POST представление нового ресурса (состав данных) отправляется на сервер через тело запроса.
Примечание — Использование для передачи данных протокола HTTP не рекомендуется.
Для идентификации конкретного ресурса, как правило, применяются параметры пути. Значение параметра передается клиентом как переменная часть URL-адреса, а затем извлекается и используется сервером во внутренней логике операции.
Параметры запроса передаются клиентом в виде пар «ключ — значение» в строке запроса в конце URL-адреса. Параметры запроса предоставляют клиенту дополнительные интерактивные возможности.
Примечание - URL — унифицированный указатель ресурса (uniform resource locator).
5 Программный интерфейс интеграции с системами фотовидеофиксации в сфере городского управления, работающими в автоматическом режиме, для получения событий
5.1 Общие положения
В настоящем разделе описаны методы программного интерфейса интеграции с СФВФ.
Для доступа к методам рекомендуется использовать надежные методы авторизации, например OAuth 2.0. В СФВФ должны применяться правила ограничения доступа. Доступ к методам должен предоставляться пользователям в зависимости от их полномочий.
Методы программного интерфейса включают в себя:
- методы получения справочника кодов событий;
- методы получения справочника источников видео- или фотофиксации;
В описании полагается размещение программного интерфейса по пути /api/.
Примечание — При разработке программного интерфейса в соответствии с настоящим стандартом допускается дополнение состава методов, параметров запросов и (или) ответов в зависимости от каждой конкретной СФВФ.
5.2 Получение справочника типов событий
Для получения справочника типов событий необходимо использовать следующий запрос:
Параметры ответа при получении справочника кода событий приведены в таблице 1.
Примеры запроса и ответа при получении результатов анализа приведены в А.1.1.
Параметры ответа при получении справочника типов событий
| Наименование | Описание | Тип данных |
|---|---|---|
| detectors | Массив, содержащий типы событий | Array |
| codename | Идентификатор типа события | String |
| name | Наименование типа события | String |
5.3 Получение справочника источников видео- или фотофиксации
Для получения справочника источников необходимо использовать следующий запрос:
Параметры запроса при получении справочника источников приведены в таблице 2.
| Наименование | Описание | Тип данных | Обязательно |
|---|---|---|---|
| type | Перечень типов источников для фильтрации | Array of String | Нет |
| id | Перечень идентификаторов источников для фильтрации | Array of String | Нет |
Ответ на запрос содержит массив элементов справочника источников. Параметры элементов массива приведены в таблице 3.
5.4 Получение событий
Для получения событий, автоматически обнаруженных СФВФ, необходимо использовать следующий запрос:
Параметры запроса и ответа при получении событий приведены в таблицах 4 и 5 соответственно.
5.5 Исключительные ситуации
5.5.1 Общие положения
Исключительные ситуации — это результат невыполненных запросов. При возникновении исключительных ситуаций модуль сервисного взаимодействия возвращает ответ в следующем формате:
Параметры ответа при возникновении исключительных ситуаций приведены в таблице 6.
5.5.2 Код 400 Bad Request
Код 400 возвращается в том случае, если исключительная ситуация спровоцирована некорректными входными параметрами (например, отсутствуют обязательные параметры запроса). Пример полезной нагрузки ответа с кодом 400:
Сообщение может содержать сведения, возвращаемые внешней системой, в таком случае к сообщению будет добавлен префикс: «Сообщение внешней системы:
5.5.3 Код 401 Unauthorized
Код 401 возвращается в том случае, если исключительная ситуация спровоцирована некорректными данными аутентификации. Ответ на запрос, спровоцировавший исключение при аутентификации, содержит сведения с описанием исключения:
Ответ содержит заголовок WWW-Authenticate, указывающий на предпочтительный способ аутентификации.
5.5.4 Код 500 Internal Server Error
Код 500 возвращается в том случае, если произошла непредвиденная внутренняя ошибка системы. Пример ответа:
«message»: «Внутренняя ошибка сервера»
Сообщение может содержать сведения о характере исключения без раскрытия деталей.
А.1 Программный интерфейс интеграции с системами фотовидеофиксации в сфере городского управления, работающими в автоматическом режиме, для аналитики состояний строительных объектов и объектов дорожного хозяйства (ОДХ)
А.1.1 Получение справочника типов событий
«name»: «Чистый скриншот КИНС»
«name»: «Повреждение искусственной неровности»
«name»: «Стертая дорожная разметка»
«name»: «Повреждение асфальтобетонного покрытия»
«name»: «Неудовлетворительное содержание цветника»
«name»: «Загрязнение опоры освещения»
«name»: «Повреждение бортового камня»
«name»:«Не очищен от снега и наледи ОДХ»
«name»:«Не очищена от снега и наледи крыша павильона остановки общественного транспорта»
«name»:«Повреждено ограждение»
«name»:«Нарушения на строительных площадках, расположенных на ОДХ»
«name»:«Объекты недвижимости, не соответствующие градостроительным нормам»
«name»:«Строительная площадка»
«name»:«Захламление территории»
А.1.2 Получение справочника источников
«id»: «8023c339-90a0-4224-be1b-57a07228b458»,
А.1.3 Получение результатов анализа
«createdAt»: «2019-08-24T14:15:22Z»,
«snapshottedAt»: «2019-08-24T14:15:22Z»,
«id»: «497f6eca-6276-4993-bfeb-53cbbbba6f08»,
«createdAt»: «2023-10-04T15:43:42.574119+03:00»,
| УДК 332:006.354 | ОКС 35.020 35.240.99 |
| Ключевые слова: умный город, системы фотовидеофиксации в сфере городского управления, API, прикладной программный интерфейс | |