Принципы взаимодействия с api: различия между версиями

Материал из База знаний АО АСП
Перейти к навигации Перейти к поиску
Нет описания правки
Нет описания правки
Строка 1: Строка 1:
======= Принципы взаимодействия с API =======
====== Принципы взаимодействия с API ======


Взаимодействие участников оборота товара (далее – УОТ) и оператора Государственной информационной системы мониторинга за оборотом товаров (далее – ГИС МТ) осуществляется в электронном виде. Обмен документами на бумажном носителе не предусмотрен.
Взаимодействие участников оборота товара (далее – УОТ) и оператора Государственной информационной системы мониторинга за оборотом товаров (далее – ГИС МТ) осуществляется в электронном виде. Обмен документами на бумажном носителе не предусмотрен.
Строка 15: Строка 15:
В API отсутствует разделение на категории участников оборота товара.
В API отсутствует разделение на категории участников оборота товара.


<syntaxhighlight lang='bash'>
'''Информация о вложенности параметров'''
'Информация о вложенности параметров
</syntaxhighlight>'


Параметр считается вложенным, если выровнен не по левому краю таблицы.
Параметр считается вложенным, если выровнен не по левому краю таблицы.
Строка 30: Строка 28:
brand.
brand.


<syntaxhighlight lang='bash'>
'''Информация о стендах/'''
'Информация о стендах/
</syntaxhighlight>'


   - [[http://ismp.crpt.ru Базовый адрес промышленного ГИС МТ]]
   - [[http://ismp.crpt.ru Базовый адрес промышленного ГИС МТ]]
   - [[http://demo.lp.crpt.tech Базовый адрес демонстрационной версии ГИС МТ]]
   - [[http://demo.lp.crpt.tech Базовый адрес демонстрационной версии ГИС МТ]]


<syntaxhighlight lang='bash'>
'''Информация об ошибках при запросах API методов имеет следующий формат:'''
'Информация об ошибках при запросах API методов имеет следующий формат:
</syntaxhighlight>'
(подробнее: см. "Справочник "Статусы ответов")
(подробнее: см. "Справочник "Статусы ответов")


<syntaxhighlight lang='bash'>
'''Пример ошибки:'''
'Пример ошибки:
</syntaxhighlight>'


<1c>
<1c>
Строка 60: Строка 52:
</1c>
</1c>


<syntaxhighlight lang='bash'>
'''Коды стран представлены в соответствии с [[https://www.iso.org/ru/iso-3166-country-codes.html ISO 3166]].'''
'Коды стран представлены в соответствии с [[https://www.iso.org/ru/iso-3166-country-codes.html ISO 3166]].
</syntaxhighlight>'
[[Category:1.1 принципы взаимодействия с api]]
[[Category:1.1 принципы взаимодействия с api]]


<vote type=1 />
<vote type=1 />

Версия от 07:58, 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].

0.00
(0 голосов)