Python и Яндекс.Диск: полное руководство по интеграции

Как работать с Яндекс.Диском без сторонних библиотек, используя только requests?

Этот вариант полезен, когда нужно минимизировать зависимости или требуется полный контроль над запросами. Используется REST API Яндекс.Диска напрямую.

Получение информации о диске

import requests
headers = {'Authorization': 'OAuth токен'}
response = requests.get('https://cloud-api.yandex.net/v1/disk', headers=headers)
print(response.json())

{'trash_size': 0, 'total_space': 107374182400, 'used_space': 2048, ...}

Создание папки

params = {'path': 'disk:/new_folder'}
response = requests.put('https://cloud-api.yandex.net/v1/disk/resources', headers=headers, params=params)
print(response.status_code)

201

Загрузка файла (два шага: получить URL для загрузки, затем загрузить)

# Получение ссылки для загрузки
params = {'path': 'disk:/new_folder/file.txt'}
response = requests.get('https://cloud-api.yandex.net/v1/disk/resources/upload', headers=headers, params=params)
url = response.json()['href']
# Загрузка файла
with open('local.txt', 'rb') as f:
    upload_response = requests.put(url, files={'file': f})
print(upload_response.status_code)

201

Удаление файла

params = {'path': 'disk:/new_folder/file.txt'}
response = requests.delete('https://cloud-api.yandex.net/v1/disk/resources', headers=headers, params=params)
print(response.status_code)

204

Как использовать протокол WebDAV для взаимодействия с Яндекс.Диском?

WebDAV предоставляет единый интерфейс для работы с файловыми хранилищами. Яндекс.Диск поддерживает WebDAV. Это удобно для интеграции с приложениями, где уже используется WebDAV.

Установка библиотеки

pip install webdavclient3

Подключение к Яндекс.Диску

from webdav3.client import Client
options = {
    'webdav_hostname': 'https://webdav.yandex.ru',
    'webdav_login': 'логин',
    'webdav_password': 'пароль'
}
client = Client(options)

Внимание: использование пароля менее безопасно, чем OAuth. Рекомендуется применять только для тестов.

Примеры операций

# Список файлов корневого каталога
files = client.list()
print(files)
# Скачивание файла
client.download('remote/path/file.txt', 'local_file.txt')
# Загрузка
client.upload('local_file.txt', 'remote/path/file.txt')
# Создание папки
client.mkdir('new_folder')

Как получить OAuth токен для доступа к API Яндекс.Диска?

Без токена невозможно использование REST API или библиотеки yadisk. Процесс состоит из регистрации приложения, получения кода авторизации и обмена его на токен.

Шаг 1: Регистрация приложения

Перейдите на https://oauth.yandex.ru/client/new, заполните поля (название, описание). В разделе Платформа выберите Веб-сервисы. Укажите Callback URL (например, https://example.com для тестов). После сохранения вы получите ID приложения и Пароль приложения.

Шаг 2: Получение кода авторизации

Сформируйте URL:

https://oauth.yandex.ru/authorize?response_type=code&client_id=ВАШ_ID&redirect_uri=ВАШ_REDIRECT_URI

Перейдите по нему, подтвердите доступ. Браузер перенаправит на redirect_uri с параметром code.

Шаг 3: Обмен кода на токен

import requests
data = {
    'grant_type': 'authorization_code',
    'code': 'полученный_код',
    'client_id': 'ваш_id',
    'client_secret': 'ваш_пароль'
}
response = requests.post('https://oauth.yandex.ru/token', data=data)
token = response.json().get('access_token')
print(token)

AgAAAA... (токен)

Токен действителен ограниченное время (обычно 1 год). Его можно сохранить и использовать повторно.