---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/en/concepts/app-folders.md
  - https://yandex.ru/dev/disk-api/doc/ru/concepts/app-folders.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

# Папки приложений

Приложения могут хранить на Диске пользователя собственные данные — например, настройки, сделанные этим пользователем или созданные им файлы. Чтобы запрашивать доступ к собственной папке на Диске, приложение следует [зарегистрировать](https://yandex.ru/dev/disk-api/doc/ru/concepts/quickstart.md#oauth) с правом **Доступ к папке приложения на Диске**.

Такое приложение сможет оперировать файлами только в рамках своей папки, если не получит также прав на общий доступ к Диску.

## Организация папок приложений

Если на Диске пользователя еще нет папки какого-либо приложения, она создается автоматически, при первом запросе с соответствующим OAuth-токеном. Имя папки соответствует имени приложения на [Яндекс.OAuth](https://oauth.yandex.ru/client/my). Если такая папка уже существует, к имени приложения добавляется его идентификатор, например `foo_4760142d81bc4b7799476b42b5103713`.

Все папки приложений создаются в системном каталоге **Приложения**. По аналогии с другими системными каталогами, его имя задается в соответствии с языком учетной записи (например, для англоязычных пользователей этот каталог называется **Apps**).


{% note alert %}

Файлы в каталоге **Приложения** полностью доступны пользователю, могут быть удалены, перемещены и переименованы.

{% endnote %}


## Путь к папке приложения

Для доступа к собственной папке можно использовать схему адреса `app:/`. Например, список ресурсов в своей корневой папке приложение может получить таким запросом:

```
https://cloud-api.yandex.net/v1/disk/resources?path=app:/
```

В ответах API пути указываются в схеме `disk:/`, с абсолютными путями к ресурсам. Например, приложение Foo получает ответ о своем файле `photo.png`:

```
{
  "name": "photo.png",
  "created": "2014-04-21T14:57:13+04:00",
  "modified": "2014-04-21T14:57:14+04:00",
  "path": "disk:/Приложения/Foo/photo.png",
  "md5": "4334dc6379c8f95ddf11b8508cfea271",
  "type": "file",
  "mime_type": "application/x-www-form-urlencoded",
  "size": 34567
}
```