Яндекс Диск REST API: GET /v1/disk/ — Данные о Диске

Возвращает объект Disk: объём Корзины, общий и занятый объём, пути системных папок.

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

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

Базовые URL

• Боевой: https://cloud-api.yandex.net
• Загрузка и скачивание файлов идут через отдельные адреса, которые API возвращает в поле .: href

Авторизация

Тип: OAuth 2.0

OAuth-токен Яндекс ID передаётся в заголовке Authorization с типом токена перед значением. Для получения токена создают OAuth-приложение с правами Диска (cloud_api:disk.write, cloud_api:disk.read, cloud_api:disk.app_folder, cloud_api:disk.info) и открывают https://oauth.yandex.ru/authorize?response_type=token&client_id=<ClientID>.

Заголовки Accept и Content-Type — только application/json.

Authorization: OAuth 0c4181a7c2cf4521964a72ff57a34a07

Нюансы

• Пути передаются в URL-кодировке; disk:/foo и /foo — одна и та же папка.
• Длительные операции (копирование, перемещение, удаление непустых папок, загрузка из интернета) возвращают 202 Accepted и объект Link на статус — статус нужно опрашивать самостоятельно.
• Объект Link: href (URL), method (HTTP-метод для него), templated (нужна ли подстановка параметров по RFC 6570).
• Ссылки на загрузку действуют 30 минут, ссылки на скачивание — ограниченное время.
• Один токен даёт одному приложению доступ к Диску одного пользователя; потерянный токен в кабинете не найти — запросите новый.

---

Если этого недостаточно — официальная документация: https://yandex.ru/dev/disk-api/doc/ru/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-disk.md