GetDepartments¶
Примечание
Вызов метода доступен только администраторам организации.
Метод GetDepartments
возвращает информацию о подразделениях организации.
- GET /admin/GetDepartments¶
- Query Parameters:
boxId – идентификатор ящика организации.
page – номер страницы, которую нужно получить. Необязательный параметр, по умолчанию равен
1
.count – количество подразделений на одной странице, максимальное значение для одной страницы. Необязательный параметр, по умолчанию равен 100.
- Request Headers:
Authorization – данные, необходимые для авторизации.
- Status Codes:
200 OK – операция успешно завершена.
400 Bad Request – данные в запросе имеют неверный формат или отсутствуют обязательные параметры.
401 Unauthorized – в запросе отсутствует HTTP-заголовок
Authorization
или в этом заголовке содержатся некорректные авторизационные данные.402 Payment Required – у организации с указанным идентификатором
boxId
закончилась подписка на API.403 Forbidden – доступ к ящику с предоставленным авторизационным токеном запрещен или запрос сделан не от имени администратора.
404 Not Found – в указанном ящике нет подразделения с указанным идентификатором.
405 Method Not Allowed – используется неподходящий HTTP-метод.
500 Internal Server Error – при обработке запроса возникла непредвиденная ошибка.
- Response Body:
Тело ответа содержит список подразделений организации, отсортированный по дате создания — от старого к новому, представленный структурой DepartmentList.
- Примечания:
Метод не возвращает удаленные подразделения.
Головное подразделение всегда первое в списке. При этом значение поля
CreationTimestamp
для него равноnull
.