Яндекс Диск REST API: Скачать файл с Диска

Сценарий из mcp-everything. Актуально на 2026-10-24.

Забрать файл, который пользователь положил в папку, — для обработки на сервере.

Получи ссылку: GET /v1/disk/resources/download с path к файлу.
Скачай файл по href из ответа обычным GET-запросом. Ссылка действует ограниченное время — запрашивай новую перед каждым скачиванием.
Чтобы найти файлы в папке, запроси её содержимое: GET /v1/disk/resources с path, limit, offset и sort (например, -modified — сначала новые). Список — в _embedded.items.

curl -s -G https://cloud-api.yandex.net/v1/disk/resources -H "$H" \
  --data-urlencode 'path=disk:/Входящие' -d limit=20 -d sort=-modified -d 'fields=_embedded.items.name,_embedded.items.path'

HREF=$(curl -s -G https://cloud-api.yandex.net/v1/disk/resources/download -H "$H" \
  --data-urlencode 'path=disk:/Входящие/scan-001.pdf' | jq -r .href)
curl -L -o scan-001.pdf "$HREF"

Базовые 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

Методы сценария

GET /v1/disk/resources — Метаинформация о файле или папке

Для ресурса в Корзине — GET /v1/disk/trash/resources.

Параметр	Где	Тип	Обяз.	Описание
`path`	query	string	да	Путь к ресурсу, в URL-кодировке
`fields`	query	string	нет	Ключи ответа через запятую, вложенные — через точку
`limit`	query	integer	нет	Число вложенных ресурсов, по умолчанию 20
`offset`	query	integer	нет	Сколько вложенных ресурсов пропустить
`preview_crop`	query	boolean	нет	Обрезать превью до квадрата, по умолчанию false
`preview_size`	query	string	нет	Размер превью: S–XXXL, ширина, высота или ШxВ
`sort`	query	string	нет	name, path, created, modified, size; дефис — обратный порядок

GET /v1/disk/resources/download — Ссылка на скачивание файла

Параметр	Где	Тип	Обяз.	Описание
`path`	query	string	да	Путь к файлу, в URL-кодировке
`fields`	query	string	нет	Ключи ответа

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

{
  "href": "https://downloader.dst.yandex.ru/disk/...",
  "method": "GET",
  "templated": false
}

Нюансы

Пути передаются в 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