Данные о Диске пользователя

API возвращает общую информацию о Диске пользователя: доступный объем, адреса системных папок и т. п.

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

Запрос данных о Диске следует отправлять с помощью метода GET.

https://cloud-api.yandex.net/v1/disk/

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

Если запрос был обработан без ошибок, API отвечает кодом 200 OK и возвращает данные о Диске в теле ответа в объекте Disk.

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

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

{
  "trash_size": 4631577437,
  "total_space": 319975063552,
  "used_space": 26157681270,
  "system_folders":
  {
    "applications": "disk:/Приложения",
    "downloads": "disk:/Загрузки/"
  }
}

Элемент

Описание

trash_size

Объем файлов, находящихся в Корзине, в байтах.

total_space

Общий объем Диска, доступный пользователю, в байтах.

used_space

Объем файлов, уже хранящихся на Диске, в байтах.

system_folders

Абсолютные адреса системных папок Диска. Имена папок зависят от языка интерфейса пользователя в момент создания персонального Диска. Например, для англоязычного пользователя создается папка Downloads, для русскоязычного — Загрузки и т. д.

На данный момент поддерживаются следующие папки:

  • applications — папка для файлов приложений;
  • downloads — папка для файлов, загруженных из интернета (не с устройства пользователя).