Получить информацию о подразделении

Возвращает информацию о подразделении по его идентификатору. В ответ не включается список участников подразделения. Чтобы посмотреть эту информацию, воспользуйтесь запросом Посмотреть информацю о подразделении на хост api360.yandex.net.

Примечание

Чтобы выполнить запрос, приложению требуется одно из разрешений:

directory:read_departments — просмотр данных подразделений;
directory:write_departments — просмотр и изменение данных подразделений.

Запрос

GET https://cloud-api.yandex.net/v1/directory/organizations/{org_id}/departments/{department_id}

Path-параметры

Имя параметра	Тип	Описание
org_id *	integer	Идентификатор организации.
department_id *	integer	Идентификатор подразделения.

Заголовки

Authorization: OAuth <токен>

Пример

Пример запроса

curl -X GET -H "Authorization: OAuth <токен>" "https://cloud-api.yandex.net/v1/directory/organizations/1/departments/2"

Ответ

Успешный ответ

Результатом корректного запроса является ответ с кодом 200 и телом в формате JSON, где содержится объект с информацией о подразделении.

200 OK — запрос выполнен успешно.

Поле	Тип	Описание
aliases	string[]	Алиасы почтовых рассылок.
created_at	string<date-time>	Дата и время создания подразделения.
description	string	Описание подразделения.
email	string	Адрес почтовой рассылки подразделения.
id	integer<int64>	Идентификатор подразделения.
label	string	Имя почтовой рассылки подразделения. Например, для адреса `new-department@ваш-домен.ru` имя почтовой рассылки — это `new-department`.
members_count	integer<int64>	Количество сотрудников подразделения с учетом вложенных подразделений.
name	string	Название подразделения.
removed	boolean	Признак удаленного подразделения: `true` — подразделение удалено; `false` — подразделение действующее.
parent_id	integer<int64>	Идентификатор родительского подразделения.
is_2fa_enabled	boolean	В разработке Статус обязательной двухфакторной аутентификации для подразделения: `false` — выключена (по умолчанию); `true` — включена.

Пример

Пример ответа

{
  "limit": 0,
  "offset": 0,
  "total": 0,
  "items": [
    {
      "id": 0,
      "name": "string",
      "description": "string",
      "label": "string",
      "members_count": 0,
      "email": "string",
      "aliases": [
        "string"
      ],
      "removed": true,
      "parent": {
        "id": 0
      },
      "created_at": "string",
      "is_2fa_enabled": false
    }
  ]
}

Неуспешный ответ

Ошибки могут быть со следующими HTTP-статусами:

400 Bad Request — параметры запроса не заданы или заданы неверно;
401 Unauthorized — пользователь не авторизован;
403 Forbidden — у пользователя или приложения нет прав на доступ к списку пользователей;
404 Not Found — запрашиваемая организация или подразделение не найдены;
500 Internal Server Error — ошибка произошла на стороне сервера (в этом случае попробуйте повторно отправить запрос через некоторое время).

Была ли статья полезна?

Получить список подразделений

Изменить статус 2FA у подразделения (в разработке)