Files
Govor/docs/endpoints/mediacontroller.md
T

3.3 KiB
Raw Blame History

description
description
Controller for uploading and downloading media files.

Медиа

Требуется роль User/Admin.

POST /api/media/upload

Content-Type: multipart/form-data. Поля:

Поле Тип Назначение
FromFile файл Непустое содержимое
Type число Image=0, Video=1, Audio=2, File=3, Voice=4
MimeType строка ≤255 MIME типа файла
EncryptedKey строка Обязательное поле запроса; сохранение ключа не реализовано
OwnerType число Message=0, Avatar=1, GroupAvatar=2, System=3

Ограничение запроса — 20 000 000 байт, включая multipart; проверка файла также ≤20 000 000. Не следует обещать загрузку файла ровно этого размера: overhead тоже входит в лимит.

Успех 200:

{"mediaId":"11111111-1111-1111-1111-111111111111","url":"2026/10/<имя файла>"}

url — относительный путь хранилища, не публичный URL. Для скачивания используйте endpoint.

GET /api/media/download/{id}

Проверяет HasAccessAsync, затем возвращает бинарный файл с MIME и Content-Disposition. Если доступа нет или запись не найдена — 403, потому что проверка доступа выполняется первой. Сервисные ошибки — через ResultExtensions.

Ограничения

Для личного сообщения accesser сравнивает Message.RecipientId с userId, хотя там ID чата: получатель может получить 403. При Send принадлежность вложения загрузившему пользователю не проверяется. OwnerType задаёт клиент, включая публично доступный System, — нужна серверная политика владения.

EncryptedKey не хранится ни в MediaFile, ни в MediaAttachments. Нельзя обещать восстановление ключа из истории.

Файлы целиком буферизуются в памяти, MIME принимается от клиента. Запись файла и БД не атомарна: возможны файлы без записи. Очистка неиспользуемых загрузок и stream-based выдача требуют реализации.


Проверено по исходникам на 03.10.2026, commit 4603be9. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.

Источник: Govor.API/Controllers/MediaController.cs.