---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/ru/reference/public-settings-get-available.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

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

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

Необходимые права доступа для OAuth-приложения:
* `cloud_api:disk.read`


## Формат запроса {#publish-q-request}

Метод: ##GET##.

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

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

path[*](*popup-a)
: Путь к публикуемому ресурсу. Например, `%2Fbar%2Fphoto.png`.

<!-- source: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->
Путь в значении параметра следует кодировать в URL-формате.
<!-- endsource: ru/_includes/reference/parameters-warehouse/id-format/path-encoding.md -->


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

### Заголовок {#header}

```
Authorization: OAuth <token>
```


## Формат ответа {#pub-set-get-response}

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

Если запрос был обработан без ошибок, API отвечает кодом `200 OK` и возвращает ссылку на опубликованный ресурс в теле ответа (в объекте [PublicAvailableSettings](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicavailablesettings)).

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

```json
{
  "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**

<!-- source: ru/_includes/reference/response-objects/id-link/publicavailablesettings-table.md -->


#|
|| **Элемент** | **Описание** ||
||`permissions` | Список доступных прав на ресурс. Возможные значения:
  - `write` — редактирование;
  - `read` — просмотр;
  - `read_without_download` — просмотр без возможности скачивания;
  - `read_with_password` — просмотр с доступом по паролю;
  - `read_with_password_without_download` — просмотр с доступом по паролю без возможности скачивания. ||
||`use_sharing` | Признак возможности предоставлять персональный доступ на опубликованный ресурс. Возможные значения: 
  - `true` — пользователь может предоставлять персональный доступ;
  - `false` — пользователь не может предоставлять персональный доступ.||
||`address_access_sharing` | На кого можно предоставить персональный доступ. Возможные значения: 
  - `inner` — только на сотрудников организации;
  - `all` — на всех пользователей. ||
||`macro_sharing` | На кого можно предоставить общий доступ. Возможные значения: 
  - `inner` — только на сотрудников организации;
  - `all` — на всех пользователей. ||
||`accesses` | Параметр предоставления доступа по-умолчанию, если флаг не включен, то отправляется пустой массив. Флаг - эксперимент public_resources_default_settings. ([Default](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#publicdefault)).||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/publicavailablesettings-table.md -->

**PublicAccesses**

<!-- source: ru/_includes/reference/response-objects/id-link/publicaccesses-table.md -->


- Общий доступ (`"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` — просмотр. ||
  |#
<!-- endsource: ru/_includes/reference/response-objects/id-link/publicaccesses-table.md -->

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

<!-- source: ru/_includes/reference/response-error.md -->
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

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

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

[*popup-path]: Путь к публикуемому ресурсу. Например, `%2Fbar%2Fphoto.png`.


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

[*popup-a]: Обязательный параметр.