ДОКУМЕНТАЦИЯ
Скачивание файлов
Одноразовая выдача после проверки права на контент.
Получение ссылки#
- POST /mods/{id}/download-tickets требует делегированный токен с областью доступа downloads:create. Необязательные поля тела: assetId и confirmed, по схеме. Проверяются покупка или подписка, условия доступа через соцсети и срок ограничения публикации.
- В data ответа приходят url на соответствующем домене dl.*, expiresIn=120 и assetId. Ссылка одноразовая и действует 120 секунд. При её использовании права проверяются снова.
- Файлы только для приложения и зашифрованные файлы не выдаются. Ссылка на скачивание — временный секрет, а не постоянный адрес хранилища. Не отправляйте Bearer-токен API на dl.*.
Отдельный бюджет файлов#
Максимум 1 GiB на файл, до 1 GiB на пользователя и до 2 GiB на API-аккаунт за сутки UTC. Дополнительно действует общий лимит сервера — не более 20 GiB в сутки. Перед выдачей резервируется полный размер файла: Range, обрыв или ошибка скачивания не возвращают этот резерв. Скорость по умолчанию — до 4 MiB/s. Это верхние ограничения, а не гарантированный объём или скорость; платный API-план их не отменяет.
Права на загрузку и скачивание#
- ZIP передаётся через /upload-sessions, ссылка Google Drive — через POST /mods или /uploads/external. Лимиты и локальные примеры — в разделе «Операции автора».
- Для платного контента нужны права пользователя; ключ чтения rh_live_ не заменяет делегированный токен.
- Скачивание через приложение, загрузка через сайт и внутренние маршруты не входят в этот публичный контракт.