sasha1981, нажала и попала на страницу со следующим содержанием.
Формат передачи данных о показателях выбросов загрязняющих веществ и (или) сбросов загрязняющих веществ по информационно-телекоммуникационным сетям с автоматических средств измерения и учета показателей выбросов загрязняющих веществ и (или) сбросов загрязняющих веществ в технические средства фиксации и передачи в государственный реестр объектов, оказывающих негативное воздействие на окружающую среду
1.0.1
OAS3
openapi.yml
Предмет и сфера действия документа
Формат передачи данных предназначен для обеспечения передачи информации о показателях выбросов загрязняющих веществ и (или) сбросов загрязняющих веществ по информационно-телекоммуникационным сетям в технические средства фиксации и передачи информации в государственный реестр объектов, оказывающих негативное воздействие на окружающую среду.
Термины и определения
ПТО УОНВОС - программно-техническое обеспечение учета объектов, оказывающих негативное воздействие на окружающую среду, используемое для ведения государственного реестра объектов, оказывающих негативное воздействие на окружающую среду.
Формат передачи данных - протокол передачи данных о показателях выбросов загрязняющих веществ в ПТО УОНВОС.
АСИ - автоматические средства измерения и учета показателей выбросов загрязняющих веществ и (или) сбросов загрязняющих веществ.
Средство измерения - техническое средство входящее в состав АСИ. Может измерять как один, так и несколько разных показателей.
ЭП - электронная подпись: Передаваемая информация подписывается усиленной квалифицированной электронной подписью юридического лица, в сертификате которой не указывается в качестве владельца такого сертификата физическое лицо, действующее от имени юридического лица.
ECDSA - (аббр. от англ. Elliptic Curve Digital Signature Algorithm) алгоритм с открытым ключом для создания цифровой подписи.
НПА - нормативный правовой акт.
HTTPS - (аббр. от англ. HyperText Transfer Protocol Secure) расширение протокола прикладного уровня передачи данных для поддержки шифрования в целях повышения безопасности.
JSON - (аббр. от англ. *** Object Notation) текстовый формат обмена данными, основанный на объектно-ориентированном языке программирования ***.
Общие положения
Общая характеристика формата передачи данных
Формат передачи данных основан на структурах формата JSON. В целях подтверждения достоверности передаваемые данные подписываются ЭП. Передача данных осуществляется по протоколу HTTPS.
Перечень измеряемых показаний, частота снятия и требования к погрешности измерений определяются соответствующими НПА. Формат передачи данных разрабатывается с учетом возможности дополнения и расширения с сохранением обратной совместимости с более ранними версиями. Формат передачи данных жестко задает форму, но предоставляет широкие возможности для изменения содержимого передаваемых данных. Все необходимые изменения и дополнения согласовываются и фиксируются в приложениях к настоящему документу.
Порядок внесения изменений и дополнений
Вводимое в эксплуатацию АСИ должно поддерживать передачу параметров согласно актуальным НПА. В случае выхода новых НПА или внесения дополнений или изменений в уже имеющиеся НПА проводится разработка новых типов передаваемых данных. Новые типы передаваемых данных вносятся в приложения к настоящему документу, информация о внесенных изменениях делается доступной для разработчиков АСИ и ПТО УОНВОС.
Работа с данными
Порядок передачи данных
Передача данных о показателях инициируется на стороне АСИ. АСИ в процессе своей работы производит измерение показаний и их накопление. Согласно требованиям НПА осуществляется усреднение измеренных показаний за установленный период времени. Усредненные значения показаний дополняются отметками времени, подписываются ЭП и отправляются посредством формата передачи данных в ПТО УОНВОС. Период отправки усредненных показаний соответствует периоду усреднения.
Передача прочих данных (служебные данные, информация о регламентных работах, нештатных ситуациях и т.п.) также инициируется на стороне АСИ. Структура с такими данными может быть отправлена вне очереди. Ситуации, при которых осуществляется передача прочих данных регламентируется соответствующими НПА.
При приеме структуры с данными на стороне ПТО УОНВОС происходит проверка целостности данных, их достоверности и формируется ответная структура с подтверждением приема. Ответная структура может содержать команду и данные для управления работой АСИ. Ответная структура должна быть подписана ЭП ПТО УОНВОС.
Если ответная структура получена АСИ и успешная отсылка усредненных показаний в ПТО УОНВОС подтверждена, АСИ продолжает работу в штатном режиме. Если ответная структура содержит команды и данные, АСИ выполняет полученную команду. Если ответная структура не получена, АСИ повторяет попытку отправки данных до получения ответной структуры. Во избежание возникновения коллизий, перегрузки каналов связи и ПТО УОНВОС интервал времени между повторными попытками увеличивается на сумму постоянного и псевдослучайного значения времени.
После выполнения команды АСИ может отправить в ПТО УОНВОС структуру с результатом выполнения команды.
ПТО УОНВОС имеет возможность послать структуру ответа в АСИ даже в том случае, если данные от АСИ не поступали. Это может быть использовано для управления работой АСИ.
В одной структуре могут содержаться несколько наборов данных в виде массива, подписанных одной ЭП.
Все числовые данные передаются как десятичные дроби или как десятичные целые числа. Время и дата передаются в числовом виде как десятичное представление UTC Unix time. ЭП и прочие бинарные данные передаются в виде текста, для чего представляются в шестнадцатеричной системе счисления.
При обмене данными между АСИ и ПТО УОНВОС не допускается использования промежуточных узлов обработки данных. Все переданные структуры при обмене данными между АСИ и ПТО УОНВОС должны получаться принимающей стороной без внесения каких-либо изменений.
Порядок работы с ЭП
Генерация и выдача ключей для формирования ЭП осуществляется организациями, уполномоченными соответствующими НПА.
В каждой отдельной структуре достаточно передать одно поле данных с ЭП. При этом ЭП рассчитывается по сумме всех наборов данных, входящих в данную структуру.
Для обмена ключами используются стандартные механизмы рукопожатия протокола HTTPS. При невозможности автоматического обмена ключей допускается передача сертификатов с ключами вручную по любым доступным каналам связи.
Структура
Описание структуры передаваемых данных (от АСИ к ПТО УОНВОС)
АСИ передает в ПТО УОНВОС JSON структуру с определяемым данным документом набором полей данных (далее - набор данных или DataSet). Обязательными для передачи являются все поля данных. АСИ может передать единовременно несколько разных показаний, для этого допускается передача в одной JSON структуре нескольких наборов полей данных в виде массива, подписанных одной ЭП.
Каждый набор данных содержит в себе все необходимое для идентификации содержимого - от какого объекта, какого средства измерения, в какое время и в каких единицах измерения были переданы данные. Для данных, содержащих усредненные показания измерений, указывается время начала и время окончания усреднения, а для данных, измеряемых на текущий момент времени - время начала всегда равно времени окончания.
Каждому набору данных АСИ присваивает идентификатор - он необходим для определения того, на какой именно набор данных от ПТО УОНВОС приходит ответ. Если же необходимо выслать данные в ответ на команду, пришедшую от ПТО УОНВОС - то используется идентификатор, сформированный ПТО УОНВОС.
Описание структуры передаваемых данных (от ПТО УОНВОС к АСИ)
ПТО УОНВОС передает в АСИ JSON структуру с определяемым данным документом набором полей данных. Обязательными для передачи являются все поля данных. ПТО УОНВОС может передать единовременно несколько разных ответов (команд), для этого допускается передача в одной JSON структуре нескольких наборов полей данных в виде массива, подписанных одной ЭП.
Каждый набор данных содержит в себе все необходимое для идентификации содержимого - для какого объекта, какого средства измерения и какая команда были переданы в ответе.
При ответе на данные, пришедшие от АСИ указывается тот идентификатор набора данных, на который формируется ответ. Если же инициатором отправки ответа (команды) является ПТО УОНВОС, то идентификатор формируется ПТО УОНВОС.
Типы передаваемых сообщений об ошибках (от ПТО УОНВОС к АСИ)
403 – В данных ошибка, данные не полные, значения выходит за допустимые пределы или тип данных неизвестен
403 – Не передано значение заголовка serial
403 – Не передано значение заголовка signature
403 – Нет зарегистрированного ключа для №{$serial}. Отладочный запрос.
403 – Нет зарегистрированного ключа для №{$serial}
403 – BadDS – Неправильная подпись для данных. Проверьте что подписываемые данные эквивалентны отправляемому телу запроса
500 – Не передано значение заголовка token или ключ недействителен
500 – Переданное значение не соответствует допустимому формату параметра
400 – Период показания 'value_uuid' параметра parameter_uuid указан не верно, timestamp_start (начало замера) должен быть меньше timestamp_end (конец замера).
400 – Окончание замера показания 'value_uuid' параметра parameter_uuid не должен быть позже текущего момента времени.
400 – Показание 'value_uuid' параметра parameter_uuid уже зафиксировано Атрибут value_uuid каждого нового значения должен быть уникален, а период измерения timestamp_start - timestamp_end не пересекаться с ранее переданными.
Пустой статус – Данные имеют разный статус передачи.
Методы авторизации
Поддерживаемые методы:
API Key (Fingerprint)
