ДОСТУПНО В BUSINESS ПОДПИСКЕ
Запрос: GET /department
Права пользователя для выполнения запроса
Владелец аккаунта, Администратор, Администратор подразделения, Автор или роль с индивидуальными настройками.
Администратор подразделения, Автор или пользователь с ролью с индивидуальными настройками могут получать информацию только о подразделениях, которыми управляют, и вложенных в них подразделениях.
Заголовки запроса
Заголовок | Описание |
|---|---|
| X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, https://myaccount.ispringlearn.ru. |
| X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками. |
| X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора, Администратора подразделения, Автора или пользователя с ролью с индивидуальными настройками. |
Параметры ответа
Параметр | Описание | |
|---|---|---|
| department | Массив с данными о подразделении. | |
| departmentId | ID подразделения. | |
| name | Название подразделения. | |
| parentDepartmentId | Родительское подразделение. | |
| code | Код подразделения. | |
| subordination (необязательный) | Объект с данными о типе подчинения линейного руководителя подразделения. | |
| coSubordination (необязательный) | Объект с данными о типе подчинения функционального руководителя подразделения. | |
| subordinationType (обязательный) | Тип подчинения линейного и фукнционального руководителя. Возможные значения:
| |
| supervisorId (необязательный) | ID руководителя. | Указываете, если subordinationType = manual. |
| - | Если subordinationType = inherit, no_supervisor, указывать не нужно. | |
Коды ответов
Код | Текст | Description |
|---|---|---|
| 200 | OK | Запрос успешно обработан. Тело ответа будет содержать данные с информацией о подразделениях в xml. |
| 400 | Bad Request | Ошибка в запросе. |
| 401 | Unauthorized | Ошибка авторизации. |
| 403 | Permission Denied | У пользователя недостаточно прав для получения списка подразделений. |
Пример запроса
GET /department https/1.1 Host: api-learn.ispringlearn.ru X-Auth-Account-Url: https://myaccount.ispringlearn.ru X-Auth-Email: email@email.com X-Auth-Password: password
Пример ответа
https/1.1 200 OK
<?xml version="1.0"?>
<response>
<department>
<departmentId>b012a71c-5b6f-11e9-b659-0a580af40556</departmentId>
<name>Отдел продаж</name>
<parentDepartmentId>b00ba37c-5b6f-11e9-bb45-0a580af40556</parentDepartmentId>
<code>5</code>
</department>
<department>
<departmentId>76b2a17a-5cff-11e9-8920-0a580af40692</departmentId>
<name>Колл-центр</name>
<parentDepartmentId>b012a71c-5b6f-11e9-b659-0a580af40556</parentDepartmentId>
<code>12</code>
</department>
<department>
<departmentId>a1c0e836-5cff-11e9-b0e0-0a580af40692</departmentId>
<name>Отдел по работе с VIP-клиентами</name>
<parentDepartmentId>b012a71c-5b6f-11e9-b659-0a580af40556</parentDepartmentId>
<code>13</code>
</department>
</response>
Рекомендованные статьи: