Принципы взаимодействия с API

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

Электронное взаимодействие осуществляется по одному из двух вариантов:

  1. Предоставление сведений, т.е. обмен электронными документами, на основании которых могут вноситься сведения в реестры ГИС МТ. Представление сведений определено как обязанность УОТ.
  2. Запрос сведений, т.е. обмен, при котором сведения из реестров ГИС МТ предоставляются УОТ в соответствии с установленными разрешениями на получение сведений. При этом изменения в реестры не вносятся. Запрос и последующее представление сведений из ГИС МТ инициируется УОТ по своему усмотрению и применяется, например, для проверки статусов КМ или статуса регистрации УОТ.

Электронное взаимодействие осуществляется путем обмена электронными документами в соответствии с определенным порядком. Для юридически значимых электронных документов применяется усиленная квалифицированная электронная подпись (УКЭП). УКЭП передается вместе с электронным документом. Электронное взаимодействие осуществляется с применением программных интерфейсов взаимодействия (API) ГИС МТ и информационных систем участников оборота товара.

При взаимодействии через API выполняются следующие требования:

  1. Аутентификация и авторизация УОТ (определение полномочий на осуществление электронного взаимодействия) осуществляется при помощи УКЭП.
  2. При предоставлении и запросе сведений защита передаваемых данных выполняется TLS/HTTPS (ГОСТ 28147-89) шифрованием канала передачи данных в адрес Оператора сертифицированными РФ СКЗИ (ГОСТ Р 34.10-2012).

В API отсутствует разделение на категории участников оборота товара.

Информация о вложенности параметров

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

Пример вложенности:

Читать как:

Параметр results содержит параметры agentInn и children, а children содержит параметр brand.

Информация о стендах:

  1. Базовый адрес промышленного ГИС МТ
  2. Базовый адрес демонстрационной версии ГИС МТ

Информация об ошибках при запросах API методов имеет следующий формат: (подробнее: см. «Справочник «Статусы ответов»)

Пример ошибки: 

// Status code: 403
Content-Type: application/json
body:
{
 "error_message": "<Отсутствует доступ к ресурсу >"
}
// Status code: 401
// информация об ошибке возвращается в формате xml
// Методы Национального каталога возвращают сообщения об ошибках, которые
могут быть как в xml, так и в json форматах в зависимости от выбранного
формата запроса

Коды стран представлены в соответствии с ISO 3166.