Запрос: POST /department
Права для выполнения запроса
Владелец аккаунта, Администратор аккаунта или роль с индивидуальными настройками, которая позволяет добавлять подразделения.
Заголовки и параметры запроса
| X-Auth-Account-Url (обязательный) | Базовый URL аккаунта, например, https://myaccount.ispringlearn.ru |
| X-Auth-Email (обязательный) | Логин Владельца аккаунта, Администратора аккаунта или пользователя с ролью с индивидуальными настройками. |
| X-Auth-Password (обязательный) | Пароль Владельца аккаунта, Администратора аккаунта или пользователя с ролью с индивидуальными настройками. |
| Параметры | Описание |
|---|---|
| name (обязательный) | Название подразделения, которое вы хотите добавить. |
| parentDepartmentId (обязательный) | ID родительского подразделения для добавляемого подразделения. |
Заголовки | Описание |
Параметры ответа
| Параметры | Описание |
|---|---|
| response | ID добавленного подразделения. |
Коды ответов
| 201 | Created | Новое подразделение добавлено. Тело ответа будет содержать ID добавленного подразделения. |
| 400 | Bad Request | Ошибка в запросе. |
| 401 | Unauthorized | Ошибка авторизации. |
| 403 | Permission Denied | Недостаточно прав у пользователя для создания подразделения. |
Код | Текст | Описание |
|---|
Пример запроса
POST /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 Content-Type:application/xml <?xml version="1.0" encoding="UTF-8"?> <request> <name>Отдел продаж</name> <parentDepartmentId>3fa85f64-5717-4562-b3fc-2c963f66afa6</parentDepartmentId> <code>12345W</code> </request>
Пример ответа
https/1.1 201 Created <?xml version="1.0" encoding="UTF-8"?> <response>d48bd4fa-5b70-11e9-b12b-22e9fbac4a59</response>