--- metadata: - name: generator content: Diplodoc Platform v5.44.0 alternate: - https://yandex.ru/dev/disk-api/doc/ru/reference/public-settings-get-admin-pkey.md --- > **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt # Получение списка всех настроек доступа к публичному ресурсу по публичному ключу ресурса или его url Метод возвращает список всех настроек доступа к публичному ресурсу сотрудника организации, в которой состоит администратор. В запросе используется публичный ключ, который может принимать одно из значений: - короткая ссылка; - полная ссылка; - хеш. Необходимые права доступа для OAuth-приложения: * `cloud_api:disk.read` ## Формат запроса {#pub-set-get-request} Метод: ##GET##. ``` https://cloud-api.yandex.net/v1/disk/public/resources/admin/public-settings ? [public_key](*popup-public_key)=<ключ или публичный URL ресурса> ``` ### Описание query-параметров {#query} public_key[*](*popup-a) : Ключ опубликованного ресурса или публичная ссылка на ресурс. Например: - короткая ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fd%2F446d6f44-bb36-48bb-973c-4e1c71e33ccd`); - полная ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fpublic%2F%3Fhash%3DdAEMkc1QDY4SPb5%252BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%253D%253D`); - хеш (`dAEMkc1QDY4SPb5%2BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%3D%3D`). Значение параметра следует кодировать в URL-формате. \* Обязательный параметр. ### Заголовок {#header} ``` Authorization: OAuth ``` где `` — токен администратора организации. ## Формат ответа {#pub-set-get-response} ### Успешный ответ Если запрос был обработан без ошибок, API отвечает кодом `200 OK` и возвращает ссылку на опубликованный ресурс в теле ответа (в объекте [PublicSettings](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicsettings)). Пример ответа: ```json { "accesses": [ { "id": 1130000066112015, "type": "user", "rights": [ "read" ], "org_id": 8012499 }, { "id": 32, "type": "group", "rights": [ "write" ], "org_id": 8012499 }, { "rights": [ "read_with_password_without_download" ], "org_id": 8012499, "type": "macro", "macros": [ "employees" ] }, { "id": 8, "type": "group", "rights": [ "write" ], "org_id": 8012499 }, { "id": 1130000066115011, "type": "owner", "rights": [ "write" ], "org_id": 8012499 } ], "available_until": null } ``` #### Описание элементов ответа **PublicSettings** #| || **Элемент** | **Описание** || ||`available_until` | Время жизни ссылки на ресурс (в секундах). По истечении указанного времени ссылка на опубликованный ресурс перестанет быть действительной. || ||`accesses` | Массив объектов, которые описывают права доступа пользователей к ресурсу ([PublicAccesses](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicaccesses)).|| |# **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` — просмотр. || |# - Доступ для владельца (`"type": "owner"`) #| || **Элемент** | **Описание** || ||`id` | Уникальный идентификатор (uid) сотрудника организации — владельца публичного ресурса. || ||`org_id` | Идентификатор организации, к которой относится сотрудник. || ||`type` | Уровень права доступа: `owner` — доступ для владельца ресурса. || ||`rights` | Права доступа к ресурсу. Всегда `write` — редактирование. || |# ### Ответ с ошибкой Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error). Некоторые возможные ошибки: * `400` — Некорректный запрос. * `401` — Не авторизован. * `403` — API недоступно. Ваши файлы занимают больше места, чем у вас есть. Удалите лишнее или увеличьте объем Диска. / Отправитель запроса не является администратором в организации. * `404` — Не удалось найти запрошенный ресурс. / Публичной ресурс не принадлежит организации, в которой состоит текущий пользователь. * `503` — Сервис временно недоступен. [*popup-public_key]: Ключ опубликованного ресурса или публичная ссылка на ресурс. Например: - короткая ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fd%2F446d6f44-bb36-48bb-973c-4e1c71e33ccd`); - полная ссылка (`https%3A%2F%2Fdisk.yandex.ru%2Fpublic%2F%3Fhash%3DdAEMkc1QDY4SPb5%252BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%253D%253D`); - хеш (`dAEMkc1QDY4SPb5%2BBlFnEKkx1oWX7%2Fp5zYSCvHGQ5%2F6FQeE4ICFyXScld621gdJYq%2FJ6bpmRyOJonT3VoXnDag%3D%3D`). Значение параметра следует кодировать в URL-формате. [*popup-a]: Обязательный параметр.