OneDrive

Интеграция с API OneDrive с использованием управляемой OAuth-аутентификации через Microsoft Graph. Позволяет работать с файлами, папками и доступами: загружать, скачивать, организовывать и делиться контентом в OneDrive.

Быстрый старт

# Получить список файлов в корневой папке OneDrive
python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/one-drive/v1.0/me/drive/root/children')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/one-drive/v1.0/{resource}

Все запросы проксируются к graph.microsoft.com с автоматическим добавлением OAuth-токена.

Аутентификация

Для всех запросов требуется API-ключ Maton, передаваемый в заголовке:

Authorization: Bearer $MATON_API_KEY

Задайте переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Управление подключениями

Управляйте OAuth-подключениями OneDrive через сервис управления соединениями.

Список подключений

GET https://ctrl.maton.ai/connections?app=one-drive&status=ACTIVE

Создание подключения

POST https://ctrl.maton.ai/connections

Удаление подключения

DELETE https://ctrl.maton.ai/connections/{connection_id}

Работа с файлами и папками

Корневая папка

GET /one-drive/v1.0/me/drive/root

Список файлов

GET /one-drive/v1.0/me/drive/root/children

Получить элемент

GET /one-drive/v1.0/me/drive/items/{item-id}

Доступ по пути

GET /one-drive/v1.0/me/drive/root:/Documents/report.pdf

Загрузка и скачивание

Загрузка файла (до 4 МБ)

PUT /one-drive/v1.0/me/drive/root:/file.txt:/content

Загрузка больших файлов

Для файлов более 4 МБ используется сессия загрузки с возможностью возобновления.

Скачивание файла

Получите метаданные файла и используйте временный URL для скачивания.

Операции с элементами

• Переименование и перемещение
• Копирование файлов
• Удаление элементов

Совместный доступ

Создание ссылки

POST /one-drive/v1.0/me/drive/items/{item-id}/createLink

Типы доступа:

• view — только просмотр
• edit — редактирование
• embed — встраивание

Приглашение пользователей

POST /one-drive/v1.0/me/drive/items/{item-id}/invite

Поиск

GET /one-drive/v1.0/me/drive/root/search(q='{query}')

Дополнительные параметры

• $select — выбор полей
• $expand — вложенные ресурсы
• $filter — фильтрация
• $orderby — сортировка
• $top — ограничение результатов

Примечания

• Используется Microsoft Graph API
• ID элементов уникальны в пределах диска
• Поддерживается адресация по пути через :
• Для больших файлов — загрузка с возобновлением
• Ссылки на скачивание временные