Б.4 Предоставление данных из профиля организации

Для получения данных об организациях система-клиент должна направить в https-адрес REST-API системы ЕСИА <33> запрос методом GET. В запросе должен быть указан ресурс, содержащий необходимые данные. Идентификатор этого ресурса в ЕСИА имеет следующий вид:

--------------------------------

<33> В тестовой среде сервис доступен по URL https://esia-portal1.test.gosuslugi.ru/rs/orgs

/orgs/{orgOid}/{collection_name}/{collection_entity_id}, где:

- orgs - коллекция организаций, имеющихся в ЕСИА;

- orgOid - внутренний идентификатор организации в ЕСИА; для определения orgOid соответствующей организации необходимо использовать атрибут orgOid, передающийся в утверждениях SAML;

- {collection_name} - ссылка на перечень (коллекцию) типов данных организации с указанным oid, возможные значения:

- ctts - контактные данные;

- addrs - адреса;

- vhls - транспортные средства;

- brhs - филиалы организации.

- {collection_entity_id} - внутренний идентификатор контакта, адреса, транспортного средства или филиала.

В запрос должен быть добавлен header с маркером доступа, позволяющим получить доступ к данному ресурсу (scope в зависимости от полномочий системы).

Пример запроса (вызов сервиса в среде разработки):

Данные, которые ЕСИА возвращает в ответ на запрос, представлены в таблице 8.