mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-17 04:58:46 +00:00
48 lines
3.3 KiB
Markdown
48 lines
3.3 KiB
Markdown
---
|
||
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:
|
||
|
||
```json
|
||
{"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](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/MediaController.cs).
|