Актуальную версию документа см. на сайте Министерства цифрового развития, связи и массовых коммуникаций Российской Федерации по адресу https://digital.gov.ru/ru/documents/6186/.
"Методические рекомендации по использованию Единой системы идентификации и аутентификации. Версия 2.84" (приложение 17 к протоколу заседания Подкомиссии по использованию информационных технологий при предоставлении государственных и муниципальных...

Таблица 10 - Параметры ответа на запрос об участниках организации

Таблица 10 - Параметры ответа на запрос

об участниках организации

N

URI запрашиваемого ресурса

Описание ресурса

Предоставляемые данные

1.

/orgs/{orgOid}/emps

Перечень сотрудников организации

Перечень сотрудников данной организации (в виде ссылок на ресурс с указанием {prn_oid}, содержащий данные о каждом сотруднике). При наличии филиалов у организации, при запросе будет возвращаться перечень сотрудников только головной организации.

2.

/orgs/{orgOid}/emps/{prn_oid}

Данные о сотруднике организации с идентификатором {prn_oid}

Данные о сотруднике:

<position> - должность;

<chief> - сведения о том, является ли сотрудник руководителем организации (в этом случае имеет значение "true") или нет ("false");

<orgOid> - идентификатор организации, сотрудником которой является пользователь;

<brhOid> - идентификатор филиала организации, сотрудником которой является пользователь (если сотрудник присоединен к филиалу);

<blocked> - признак блокировки сотрудника (имеет значение "true" или "false").

Для просмотра перечня сотрудников филиала организации необходимо указать в запросе параметр brhOid и значение идентификатора соответствующего филиала. Пример ссылки, по которой будет возвращен перечень сотрудников филиала с идентификатором 1004082214:

https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000001/emps?brhOid=1004082214

При отображении всех коллекций (orgs, emps) используется механизм paging.

Пример ответа на запрос сведений о перечне сотрудников организации с идентификатором 1000000000 (фрагмент, разрывы строк даны для удобства чтения):

{

"stateFacts": ["hasSize"],

"elements":[

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/222896320",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/240612402",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280304",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280305",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/243280312",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000008",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000009",

"https://esia-portal1.test.gosuslugi.ru/rs/orgs/1000000000/emps/1000000385"

],

"size":"8"

}

Пример ответа с контактными данными о сотрудниках организации при использовании возможности встраивания <38> (разрывы строки даны для удобства чтения):

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

<38> Запрос ресурса: /orgs/100000/emps?embed=(elements.person)

{

"stateFacts": ["Paginated", "FirstPage", "LastPage"],

"elements": [

{

"stateFacts": ["Identifiable"],

"prnOid": 1000000125,

"orgOid": 100000,

"chief": false,

"corporateContact": "mail@example.com",

"person": {

"stateFacts": ["Identifiable"],

"firstName": "Петр",

"lastName": "Петров",

"middleName": "Петрович",

"gender": "M",

"updatedOn": 1387519441

}

},

{

"stateFacts": ["Identifiable"],

"prnOid": 1000004892,

"orgOid": 100000,

"position": "Руководитель",

"chief": true,

"person": {

"stateFacts": ["Identifiable"],

"firstName": "Иван",

"lastName": "Иванов",

"middleName": "Иванович",

"gender": "M",

"updatedOn": 1387466948

}

}

],

"pageSize": 100,

"pageIndex": 1

}

Б.5 Предоставление списка участников организации Б.6 Предоставление сведений о вхождении пользователя в группы