Получение списка своих настроек доступа к ресурсу

Метод возвращает список настроек доступа к ресурсу для владельца OAuth-токена, отправляемого в заголовке запроса.

Необходимые права доступа для OAuth-приложения:

• cloud_api:disk.read

Формат запроса

Метод: GET.

https://cloud-api.yandex.net/v1/disk/public/resources/public-settings/available-settings
 ? path=<путь к публикуемому ресурсу>

Описание query-параметров

path*

Путь к публикуемому ресурсу. Например, %2Fbar%2Fphoto.png.

Путь в значении параметра следует кодировать в URL-формате.

* Обязательный параметр.

Заголовок

Authorization: OAuth <token>

Формат ответа

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

Если запрос был обработан без ошибок, API отвечает кодом 200 OK и возвращает ссылку на опубликованный ресурс в теле ответа (в объекте PublicAvailableSettings).

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

{
  "permissions": [
    "read",
    "read_with_password",
    "read_with_password_without_download",
    "read_without_download",
    "write"
  ],
  "address_access_sharing": "all",
  "use_sharing": true,
  "macro_sharing": "all",
  "default": []
}

Описание элементов ответа

PublicAilableSettings

PublicAccesses

• Общий доступ ("type": "macro")

  Элемент	Описание
  macros	Массив, который содержит информацию о том, будет ли общий доступ к ресурсу с указанными правами предоставлен только внутри организации или для любых пользователей. Возможные значения: employees — общий доступ к ресурсу только внутри определенной организации; all — общий доступ для всех пользователей.
  org_id	Идентификатор организации, сотрудникам которой предоставляется общий доступ к ресурсу с правами, указанными в параметре rights данного объекта. Указывается, только если параметр macros имеет значение employees.
  type	Уровень права доступа: macro — общий доступ.
  rights	Права доступа к ресурсу. Возможные значения: write — редактирование; read — просмотр; read_without_download — просмотр без возможности скачивания; read_with_password — просмотр с доступом по паролю; read_with_password_without_download — просмотр с доступом по паролю без возможности скачивания.

• Персональный доступ для сотрудников ("type": "user")

  Элемент	Описание
  id	Уникальный идентификатор (uid) сотрудника организации, которому предоставлен персональный доступ к ресурсу с правами, указанными в параметре rights данного объекта.
  org_id	Идентификатор организации, к которой относится сотрудник.
  type	Уровень права доступа: user — персональный доступ для сотрудника организации.
  rights	Права доступа к ресурсу. Возможные значения: write — редактирование; read — просмотр.

• Персональный доступ для групп ("type": "group")

  Элемент	Описание
  id	Уникальный идентификатор (id) группы в организации, которой предоставлен персональный доступ к ресурсу с правами, указанными в параметре rights данного объекта.
  org_id	Идентификатор организации, которой принадлежит группа.
  type	Уровень права доступа: group — персональный доступ для группы.
  rights	Права доступа к ресурсу. Возможные значения: write — редактирование; read — просмотр.

• Персональный доступ для подразделений ("type": "department")

  Элемент	Описание
  id	Уникальный идентификатор (id) подразделения в организации, которому предоставлен персональный доступ к ресурсу с правами, указанными в параметре rights данного объекта.
  org_id	Идентификатор организации, которой принадлежит подразделение.
  type	Уровень права доступа: department — персональный доступ для подразделения.
  rights	Права доступа к ресурсу. Возможные значения: write — редактирование; read — просмотр.

Ответ с ошибкой

Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит описание ошибки.

Некоторые возможные ошибки:

• 400 — Некорректный запрос.
• 401 — Не авторизован.
• 403 — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объём Диска.
• 404 — Не удалось найти запрошенный ресурс.
• 503 — Сервис временно недоступен.

Путь в значении параметра следует кодировать в URL-формате.