Принципы взаимодействия с api: различия между версиями
Shihov (обсуждение | вклад) Нет описания правки |
Shihov (обсуждение | вклад) Нет описания правки |
||
| Строка 30: | Строка 30: | ||
'''Информация о стендах/''' | '''Информация о стендах/''' | ||
- | - [http://ismp.crpt.ru Базовый адрес промышленного ГИС МТ] | ||
- | - [http://demo.lp.crpt.tech Базовый адрес демонстрационной версии ГИС МТ] | ||
'''Информация об ошибках при запросах API методов имеет следующий формат:''' | '''Информация об ошибках при запросах API методов имеет следующий формат:''' | ||
| Строка 52: | Строка 52: | ||
</1c> | </1c> | ||
'''Коды стран представлены в соответствии с | '''Коды стран представлены в соответствии с [https://www.iso.org/ru/iso-3166-country-codes.html ISO 3166].''' | ||
[[Category:1.1 принципы взаимодействия с api]] | [[Category:1.1 принципы взаимодействия с api]] | ||
<vote type=1 /> | <vote type=1 /> | ||
Версия от 08:03, 28 марта 2025
Принципы взаимодействия с API
Взаимодействие участников оборота товара (далее – УОТ) и оператора Государственной информационной системы мониторинга за оборотом товаров (далее – ГИС МТ) осуществляется в электронном виде. Обмен документами на бумажном носителе не предусмотрен.
Электронное взаимодействие осуществляется по одному из двух вариантов:
- Предоставление сведений, т.е. обмен электронными документами, на основании которых могут вноситься сведения в реестры ГИС МТ. Представление сведений определено как обязанность УОТ. - Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ предоставляются УОТ в соответствии с установленными разрешениями на получение сведений. При этом изменения в реестры не вносятся. Запрос и последующее представление сведений из ГИС МТ инициируется УОТ по своему усмотрению и применяется, например, для проверки статусов КМ или статуса регистрации УОТ.
Электронное взаимодействие осуществляется путем обмена электронными документами в соответствии с определенным порядком. Для юридически значимых электронных документов применяется усиленная квалифицированная электронная подпись (УКЭП). УКЭП передается вместе с электронным документом. Электронное взаимодействие осуществляется с применением программных интерфейсов взаимодействия (API) ГИС МТ и информационных систем участников оборота товара.
При взаимодействии через API выполняются следующие требования:
- Аутентификация и авторизация УОТ (определение полномочий на осуществление электронного взаимодействия) осуществляется при помощи УКЭП. - При предоставлении и запросе сведений защита передаваемых данных выполняется TLS/HTTPS (ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).
В API отсутствует разделение на категории участников оборота товара.
Информация о вложенности параметров
Параметр считается вложенным, если выровнен не по левому краю таблицы.
Пример вложенности:
Читать как/
Параметр results содержит параметры agentInn и children, а children содержит параметр brand.
Информация о стендах/
- Базовый адрес промышленного ГИС МТ - Базовый адрес демонстрационной версии ГИС МТ
Информация об ошибках при запросах API методов имеет следующий формат: (подробнее: см. "Справочник "Статусы ответов")
Пример ошибки:
<1c> // Status code: 403 Content-Type: application/json body: {
"error_message": "<Отсутствует доступ к ресурсу >"
} // Status code: 401 // информация об ошибке возвращается в формате xml // Методы Национального каталога возвращают сообщения об ошибках, которые могут быть как в xml, так и в json форматах в зависимости от выбранного формата запроса </1c>
Коды стран представлены в соответствии с ISO 3166.

