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

Приложения могут хранить на Диске пользователя собственные данные — например, настройки, сделанные этим пользователем или созданные им файлы. Чтобы запрашивать доступ к собственной папке на Диске, приложение следует зарегистрировать с правом Доступ к папке приложения на Диске.

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

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

Если на Диске пользователя еще нет папки какого-либо приложения, она создается автоматически, при первом запросе с соответствующим OAuth-токеном. Имя папки соответствует имени приложения на Яндекс.OAuth. Если такая папка уже существует, к имени приложения добавляется его идентификатор, например foo_4760142d81bc4b7799476b42b5103713.

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

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

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

Для доступа к собственной папке можно использовать схему адреса 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
}