Документация MMW Cloud

Начало работы

MMW Cloud представляет собой защищенное персональное облачное хранилище для надежного размещения ваших документов, персональных архивов, медиафайлов и рабочих материалов.

Веб-кабинет сервиса работает по адресу https://app.mmwcloud.tech и адаптирован для использования как с компьютеров, так и с мобильных телефонов. Для входа используется электронная почта и пароль, либо быстрый переход из экосистемы MMW.

Основные элементы кабинета

Загрузка и папки

Файлы можно добавлять через кнопку «Загрузить файл» или простым перетаскиванием в окно браузера.

Система папок и категорий

В верхней части списка файлов расположены удобные фильтры по категориям:

Кнопка «Показать ещё» открывает дополнительные категории при наличии соответствующих файлов в хранилище.

Действия с файлами

Тарифы и оплата

Для пользователей в рублях действуют четыре понятных тарифных плана с ежемесячной оплатой.

Условия подписки и платежи

Управление подпиской также доступно в карточке MMW Cloud кабинета app.mmwhub.ru. После нажатия кнопки отмены автопродления повторные списания прекращаются. Все функции хранилища продолжают работать до даты окончания оплаченного срока.

Отмена и что будет с файлами

Политика хранения данных четко регламентирует каждый этап после завершения оплаченного периода.

Вход в экосистеме MMW

MMW Cloud является частью единой рабочей среды MMW и использует общую систему авторизации.

Бесшовный вход выполняется через безопасный одноразовый код авторизации со сроком жизни 60 секунд. Код передается во фрагменте интернет-адреса, благодаря чему он исключен из журналов веб-серверов и браузерных заголовков. Сразу после активации код аннулируется.

Связь с памятью агентов (agent_sync)

Безопасность хранения

API разработчика

MMW Cloud предоставляет интерфейс REST API для автоматизации работы с файлами и квотой хранилища.

Ключи API и авторизация

Для программного доступа к сервису используются персональные ключи API. Создать ключ можно в веб-кабинете: откройте вкладку Профиль и перейдите к блоку «Ключи API». Задайте название ключа, отметьте требуемые права доступа и выберите срок действия.

Формат ключа: mmwc_<prefix>_<secret>. Префикс состоит из 16 шестнадцатеричных символов, секрет содержит 43 символа. Полное значение ключа отображается один раз сразу после генерации. На сервере сохраняется только хеш SHA-256 от секрета. Если секрет утерян, ключ потребуется перевыпустить.

На одном аккаунте допускается до 10 действующих ключей одновременно. Истекшие по сроку или отозванные ключи не входят в этот лимит. Отозвать ключ можно в любой момент кнопкой «Отозвать» в списке ключей профиля с подтверждением действия.

Базовый адрес API: https://api.mmwcloud.tech/v1

Каждый запрос должен содержать заголовок авторизации с действующим ключом:

Authorization: Bearer mmwc_<prefix>_<secret>

Права доступа (scopes)

Права ключа задаются при создании и определяют перечень разрешенных операций:

Маршруты API

Процесс загрузки и скачивания

Загрузка файлов выполняется в три шага:

1. Шаг 1: клиент отправляет POST /files/upload-ticket с размером и SHA-256 файла, получая тикет со ссылками.
2. Шаг 2: бинарное содержимое передается методом PUT по выданной ссылке (для большого файла по ссылкам частей, сохраняя ETag из JSON-ответа на каждую часть).
3. Шаг 3: клиент вызывает POST /files/complete для фиксации загрузки и ожидает статус ready через периодический опрос GET /files/{file_id}.

Скачивание выполняется через запрос GET /files/{file_id}/download. Сервер возвращает JSON с адресом download_url. Клиент скачивает файл стандартным GET-запросом по этой временной ссылке.

Ограничения и формат ошибок

К API метаданных применяется ограничение частоты: 120 запросов в минуту на каждый ключ. При превышении порога возвращается HTTP 429 с кодом rate_limit_exceeded и заголовком Retry-After, указывающим время ожидания в секундах.

В случае ошибки API возвращает стандартный JSON объект:

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Превышен лимит запросов",
    "request_id": "4b68e210ac124b868e826b5278c5208f",
    "details": {}
  }
}

Каждый ответ API сопровождается заголовком X-Request-ID для отслеживания запросов.

Примеры использования (curl)

Получение списка файлов:

curl -s -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere" \
  https://api.mmwcloud.tech/v1/files

Проверка квоты:

curl -s -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere" \
  https://api.mmwcloud.tech/v1/quota

Загрузка небольшого файла: шаг 1, получение тикета:

# Размер и SHA-256 файла
SIZE=$(stat -c %s document.pdf)
SHA=$(sha256sum document.pdf | cut -d" " -f1)

curl -s -X POST https://api.mmwcloud.tech/v1/files/upload-ticket \
  -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere" \
  -H "Content-Type: application/json" \
  -d "{\"name\": \"document.pdf\", \"size_bytes\": $SIZE, \"sha256\": \"$SHA\"}"

Загрузка небольшого файла: шаг 2, передача содержимого по полученному upload_url:

curl -s -X PUT "https://storage.mmwcloud.tech/v1/upload/file_id?capability=token" \
  -H "Content-Type: application/octet-stream" \
  --data-binary @document.pdf

Загрузка небольшого файла: шаг 3, фиксация загрузки:

curl -s -X POST https://api.mmwcloud.tech/v1/files/complete \
  -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere" \
  -H "Content-Type: application/json" \
  -d '{"id": "file_id"}'

Получение временной ссылки на скачивание:

curl -s -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere" \
  https://api.mmwcloud.tech/v1/files/file_id/download

Скачивание файла по полученной ссылке download_url:

curl -s -o document.pdf "https://storage.mmwcloud.tech/v1/download/file_id?capability=token"

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

curl -s -X DELETE https://api.mmwcloud.tech/v1/files/file_id \
  -H "Authorization: Bearer mmwc_0123456789abcdef_secretkeyhere"

Вопросы и ответы