| Включить страницу |
|---|
L3:Лэйблы с указанием тарифа | L3:Лэйблы с указанием тарифа | Метод: getDepartment
Параметры запроса
| Параметр | Тип | Описание |
|---|
| credentials (обязательный) | credentials | Смотрите описание объекта Credentials. |
| departmentId (обязательный) | string | ID подразделения, информацию о котором нужно получить. |
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор аккаунта, Администратор подразделения, Автор или роль с индивидуальными настройками.
Администратор подразделения, Автор или пользователь с ролью с индивидуальными настройками могут получать информацию только о подразделениях, которыми управляют, и их дочерних подразделениях.
Возвращаемые значения
После того как запрос успешно обработан, система отправляет объект со следующими свойствами:
| Параметр | Тип | Описание |
|---|
| department | array | Массив, содержащий значения ’departmentId’, ’name’, ’code’, ’parentDepartmentId’ — ID подразделения, его название, код и родительское подразделение. |
| department_id (обязательный) | string | ID подразделения, о котором вы хотите получить информацию. |
| name | string | Название подразделения. |
| code | string | Код подразделения. |
| parentDepartmentId | string | ID головного подразделения. |
| subordination (необязательный) | array | Объект с данными о типе подчинения линейного руководителя подразделения. |
| coSubordination (необязательный) | array | Объект с данными о типе подчинения функционального руководителя подразделения. |
| subordinationType (обязательный) | string | Тип подчинения линейного и фукнционального руководителя. Возможные значения: - inherit — Наследуется от вышестоящего подразделения.
- manual — Указать вручную.
- no_supervisor — Без руководителя.
|
| supervisorId (необязательный) | string | ID руководителя. | Указываете, если subordinationType = manual. |
| - | Если subordinationType = inherit, no_supervisor, указывать не нужно. |
Пример запроса
| Блок кода |
|---|
|
<?xml version="1.0" encoding="utf-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<GetDepartmentRequest>
<credentials>
<accountUrl>https://myaccount.ispringlearn.ru</accountUrl>
<email>email@email.com</email>
<password>password</password>
</credentials>
<departmentId>string</departmentId>
</GetDepartmentRequest>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |
Пример ответа
| Блок кода |
|---|
|
<SOAP-ENV:Envelope xmlns:SOAP-ENV="https://schemas.xmlsoap.org/soap/envelope/"
xmlns="https://ispringlearn.com/go/services/api/soap">
<SOAP-ENV:Body>
<GetDepartmentResult>
<department>
<departmentId>string</departmentId>
<name>string</name>
<code>string</code>
<parentDepartmentId>string</parentDepartmentId>
</department>
</GetDepartmentResult>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope> |