Request: POST /user/{userId}/subordination
С помощью данного метода вы сможете назначать линейных и функциональных руководителй для сотрудников.
Права для выполнения запроса
Владелец и Администратор аккаунта или роль с индивидуальными настройками, которая позволяет просматривать, создавать, редактировать и удалять пользователей.
Администратор подразделения и пользователь с ролью с индивидуальными настройками могут назначать руководителя только на сотрудников своего подразделения.
- Владелец и Администратор аккаунта могут назначить себя руководителями.
- Администратор подразделения и пользователь с ролью с индивидуальными настройками не могут назначать себя руководителем.
Заголовки и параметры запроса
Заголовок | Описание | |
|---|---|---|
| X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, https://myaccount.ispringlearn.ru | |
| X-Auth-Email (обязательный) | Логин Владельца и Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками. | |
| X-Auth-Password (обязательный) | Пароль Владельца и Администратора аккаунта, Администратора подразделения или пользователя с ролью с индивидуальными настройками. | |
| userId (обязательный) | ID пользователя, для которого вы назначаете руководителя. | |
| Параметр | Описание | |
| subordination (необязательный) | Объект с данными о типе подчинения линейного руководителя сотрудника. | |
| coSubordination (необязательный) | Объект с данными о типе подчинения функционального руководителя сотрудника. | |
| subordinationType (обязательный) | Тип подчинения линейного и фукнционального руководителя. Возможные значения:
| |
| supervisorId (необязательный) | ID руководителя. | Указываете, если subordinationType = manual. |
| - | Если subordinationType = inherit, no_supervisor, указывать не нужно. | |
Коды ответов
Код | Текст | Описание |
|---|---|---|
| 204 | No Content | Руководитель назначен на сотрудника. |
| 400 | Bad Request | Ошибка в запросе. |
| 401 | Unauthorized | Ошибка авторизации. |
| 403 | Permission denied | У пользователя недостаточно прав для выполнения запроса. |
Пример запроса
POST /user/{userId}/subordination
Host: api-learn.ispringlearn.ru
X-Auth-Account-Url: https://myaccount.ispringlearn.ru
X-Auth-Email: email@email.ru
X-Auth-Password: password
Content-Type:application/xml
<request>
<subordination>
<subordinationType>manual</subordinationType>
<supervisorId>0ccca211-b60f-11ea-bc49-028d9ecdf612</supervisorId>
</subordination>
<coSubordination>
<subordinationType>no_supervisor</subordinationType>
</coSubordination>
</request>
Пример ответа
https/1.1 204 No Content