mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-18 21:34:56 +00:00
Add forwarding, friend controls, and benefits
Add message forwarding and reply lookup, friend removal and blocking endpoints, and database-backed Govor+ privileges with customizable profile tags. Include migrations, integration tests, and updated API and operations documentation.
This commit is contained in:
@@ -1,42 +1,37 @@
|
||||
# Медиа
|
||||
# Медиа и вложения
|
||||
|
||||
Требуется роль User/Admin.
|
||||
Требуются access token и роль User/Admin. Загрузка файла и отправка сообщения — отдельные операции.
|
||||
|
||||
## POST /api/media/upload
|
||||
|
||||
Content-Type: multipart/form-data. Поля:
|
||||
`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 |
|
||||
| Поле | Назначение |
|
||||
| --- | --- |
|
||||
| `FromFile` | Непустой бинарный файл |
|
||||
| `Type` | Число: Image=0, Video=1, Audio=2, File=3, Voice=4 |
|
||||
| `MimeType` | Обязательная строка до 128 символов |
|
||||
| `OwnerType` | Здесь разрешены только Message=0 и Avatar=1 |
|
||||
| `EncryptedKey` | Для сообщения отсутствует или пустая строка; ключ расшифровки передавать нельзя |
|
||||
|
||||
Ограничение запроса — 20 000 000 байт, включая multipart; проверка файла также ≤20 000 000. Не следует обещать загрузку файла ровно этого размера: overhead тоже входит в лимит.
|
||||
Для `OwnerType=Message` клиент **сначала шифрует файл**. `MimeType` должен совпадать с `E2eeProtocol.EncryptedMimeType`; сервер сохраняет случайное имя `.bin` и тип File. Оригинальные имя, MIME и ключ содержатся внутри зашифрованного сообщения, не в открытых полях upload.
|
||||
|
||||
Успех 200:
|
||||
Лимит всего запроса и multipart — `20 000 000` байт; такой же предел проверяется для файла. Overhead формы и шифрования тоже занимает место: нельзя обещать загрузку исходного файла ровно 20 MB. Аватары не являются E2EE-вложениями; доступ к ним и профильный upload описаны отдельно.
|
||||
|
||||
Успех `200`:
|
||||
|
||||
```json
|
||||
{"mediaId":"11111111-1111-1111-1111-111111111111","url":"2026/10/<имя файла>"}
|
||||
{"mediaId":"11111111-1111-1111-1111-111111111111","url":"<путь в хранилище>"}
|
||||
```
|
||||
|
||||
url — относительный путь хранилища, не публичный URL. Для скачивания используйте endpoint.
|
||||
`url` — внутренний путь, не публичная ссылка. Для сообщения используйте `mediaId` в списке вложений и метаданных зашифрованного конверта. Send проверяет загрузчика, тип владения, уникальность ID и соответствие вложений подписанному конверту. Чужой файл прикрепить нельзя.
|
||||
|
||||
## GET /api/media/download/{id}
|
||||
|
||||
Проверяет HasAccessAsync, затем возвращает бинарный файл с MIME и Content-Disposition. Если доступа нет или запись не найдена — 403, потому что проверка доступа выполняется первой. Сервисные ошибки — через ResultExtensions.
|
||||
Возвращает бинарный файл после проверки доступа. Для вложений учитывается участие в личном чате/группе и бан; непривязанная к сообщению загрузка не получает доступ к download только по признаку uploader. Отсутствие доступа или неизвестный ID могут дать `403`, поскольку доступ проверяется до чтения.
|
||||
|
||||
Ответ имеет `Cache-Control: no-store` и `X-Content-Type-Options: nosniff`. Клиент расшифровывает содержимое и проверяет целостность перед отображением. Не используйте серверное имя/MIME зашифрованного файла как оригинальные пользовательские метаданные.
|
||||
|
||||
## Ограничения
|
||||
|
||||
Для личного сообщения 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).
|
||||
Файлы буферизуются в памяти; запись в файловую систему и БД не образует единую транзакцию. Возможны неиспользованные файлы после сбоя/отмены отправки. Не удаляйте их по одному признаку возраста без проверки ссылок. [Хранение и резервные копии](../operations.md).
|
||||
|
||||
Reference in New Issue
Block a user