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

Б.12.4 Сервис REST API прикрепления сотрудников к ЦО

Возможно присоединение к ЦО только подтвержденных УЗ сотрудников организации.

Поиск УЗ осуществляется по СНИЛС только в подтвержденных УЗ.

Адрес метода:

URL: esia-rs/api/public/v1/orgs/{org_oid}/rcs/{rc_oid}/invts/force

Входные параметры:

На вход сервис должен получать коллекцию объектов, описывающих УЗ пользователей, которых необходимо прикрепить к ЦО.

По умолчанию, максимальное количество пользователей в одном запросе 100.

org_oid - идентификатор организации, к ЦО которой прикрепляется пользователь;

rc_oid - идентификатор ЦО, к которому нужно прикрепить УЗ пользователя;

Параметры тела запроса:

firstName - имя;

lastName - фамилия;

middleName - отчество;

snils - СНИЛС

HTTP метод: POST

Пример запроса:

POST esia-rs/api/public/v1/orgs/1000000001/rcs/1000000234/invts/force HTTP/1.1

Host: esia-portal1.test.gosuslugi.ru

Authorization: Bearer

eyJhbGciOiJSUzI1NiIsInNidCI6ImFjY2VzcyIsInR5cCI6IkpXVCIsInZlciI6MX0eyJleHAiOjE0NDY

yMTU2ND

Content-Type: application/json

Cache-Control: no-cache

[

{

"snils": "000-000-000 01",

"firstName": "Михаил",

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

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

},

{

"snils": "000-000-000 01",

"firstName": "Петр",

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

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

},

{

"snils": "000-000-0 01",

"firstName": "Вадим",

"lastName": "Вадимов",

"middleName": "Вадимович"

},

{

"snils": "000-000-000 99",

"firstName": "Николай",

"lastName": "Николаев",

"middleName": "Николаевич"

}

]

Ответ с результатом будет отсортирован в том же порядке, как и при запросе.

Пример ответа:

{

"oid ": "1000000234", // идентификатор ЦО в который добавлялись

пользователи

"message": "Success|Partial success|Fail",

"results": [

{ "snils":"000-000-000 01", "message": "Success"},

{ "snils":"000-000-000 02", "message": "Success"},

{ "snils":"000-000-0 01", "message": "ESIA-036101"},

// ... ответ будет отсортирован в том же порядке, как и при запросе

{ "snils":"000-000-000 99", "message": "Success"}

]

}

Перечень возможных возвращаемых ошибок:

Код

Описание

ESIA-038000

Организация не найдена

ESIA-038900

Центр обслуживания не найден

ESIA-038901

Центр обслуживания не принадлежит организации

ESIA-036101

Некорректный формат СНИЛС

ESIA-020002

Пользователь не найден

ESIA-039961

Пользователь, учетная запись которого найдена по указанному в запросе СНИЛС, не является сотрудником организации, org_oid которой указан в запросе

Требуемый scope:

org_invts_force?org_oid={p.org_oid}&mode=w

Поиск ЦО организации Б.13 Сервис получения маркера доступа по идентификационному ключу