mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-17 12:59:25 +00:00
docs: split messaging and privileges guides
Organize reply/forward and friendship guidance into focused endpoint docs, add Govor+ privilege, profile-tag, and realtime guides, and document migrations and verification results.
This commit is contained in:
@@ -26,3 +26,17 @@ Bearer token обязателен; отдельная роль в атрибут
|
||||
|
||||
|
||||
Источник: [Govor.API/Controllers/Friends/FriendshipController.cs](https://github.com/stalcker2288969/Govor/blob/a3401ceedf30c2eb6167f7ef6e4ae820883d2de2/Govor.API/Controllers/Friends/FriendshipController.cs).
|
||||
|
||||
## Удаление из друзей и блокировка
|
||||
|
||||
| HTTP | Действие |
|
||||
| ------------------------------------ | ---------------------------- |
|
||||
| `DELETE /api/friends/{userId}` | Удалить принятую дружбу |
|
||||
| `PUT /api/friends/{userId}/block` | Заблокировать пользователя |
|
||||
| `DELETE /api/friends/{userId}/block` | Снять собственную блокировку |
|
||||
|
||||
Успех — `204`. Идентификатор текущего пользователя всегда берётся из JWT. Пустой ID и действие на себя дают `400`; блокировка несуществующего пользователя — `404`; изменение чужой блокировки — `403`.
|
||||
|
||||
Удаление идемпотентно, переводит принятую дружбу в `Rejected`, сохраняет историю чата и не снимает блокировку. Само удаление дружбы не запрещает отправку в ранее созданный чат: для этого нужна блокировка. Блокировка может создаваться без дружбы, исключает пользователя из друзей и запрещает новые сообщения в личном чате в обе стороны, а также новые заявки. Чтение истории и общие группы сохраняются.
|
||||
|
||||
Используется существующая модель `FriendshipStatus.Blocked`: у пары одна блокировка, её владелец записан как `RequesterId`. Только владелец может снять её; вторая сторона не может заменить владельца. Повтор собственной блокировки безопасен. Снятие блокировки не восстанавливает дружбу: требуется новая заявка и согласие получателя.
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
# Ответы и пересылки сообщений
|
||||
|
||||
Сообщения отправляются через ChatsHub.Send в /hubs/chats. Требуется access JWT и право отправки в чат. Для личного чата recipientId — PrivateChat.Id, recipientType — 0. Те же механизмы поддерживаются в группах и каналах с recipientType — 1 и соответствующей проверкой членства/роли.
|
||||
|
||||
## Ответ на сообщение
|
||||
|
||||
Вызовите `Send` в `/hubs/chats`, указав `replyToMessageId`:
|
||||
|
||||
```json
|
||||
{
|
||||
"recipientId": "<chat-id>",
|
||||
"recipientType": 0,
|
||||
"encryptedContent": "<fresh E2EE envelope>",
|
||||
"replyToMessageId": "<original-message-id>",
|
||||
"mediaAttachments": []
|
||||
}
|
||||
```
|
||||
|
||||
`recipientType`: `0` — личный чат, `1` — группа/канал. Ответ должен ссылаться на существующее сообщение того же чата и типа. Сервер проверяет право отправки, включая блокировку в личном чате, бан в группе и роль администратора канала. Для E2EE `replyToMessageId` должен совпадать с `replyTo` подписанного конверта. В публичных группах допускается обычное содержимое согласно существующей политике.
|
||||
|
||||
Связь возвращается в результате `Send`, событиях сообщений и истории. Для превью ответа за пределами загруженной страницы используйте `GET /api/messages/{messageId}`. Ответ — `MessageResponse` с вложениями, реакциями и прочтениями. Отсутствующее сообщение и отсутствие доступа дают одинаковый `404`, без раскрытия чужого чата. После удаления оригинала ссылка остаётся; клиент показывает «Сообщение удалено». Содержимое удалённого сообщения сервер не архивирует в ответе.
|
||||
|
||||
## Пересылка
|
||||
|
||||
Используется тот же `Send`; добавьте `forwardedFromMessageId`, передайте новое содержимое и принадлежащие отправителю вложения для чата назначения:
|
||||
|
||||
```json
|
||||
{
|
||||
"recipientId": "<destination-chat-id>",
|
||||
"recipientType": 0,
|
||||
"encryptedContent": "<new envelope encrypted for destination devices>",
|
||||
"forwardedFromMessageId": "<source-message-id>",
|
||||
"mediaAttachments": []
|
||||
}
|
||||
```
|
||||
|
||||
Сервер проверяет доступ отправителя к исходному сообщению и право отправки в чат назначения. Несуществующий или недоступный источник отклоняется без записи сообщения и push. Автор и дата источника берутся из БД, клиент не может передать их сам:
|
||||
|
||||
| Поле ответа/истории | Значение |
|
||||
| ------------------------ | -------------------------------------------- |
|
||||
| `senderId` | Пользователь, выполнивший пересылку |
|
||||
| `forwardedFromMessageId` | ID непосредственно пересланного сообщения |
|
||||
| `forwardedFromUserId` | Автор непосредственно пересланного сообщения |
|
||||
| `forwardedFromSentAt` | Дата отправки источника, UTC |
|
||||
|
||||
Это снимок происхождения без внешнего ключа: удаление источника не удаляет пересылку. При повторной пересылке указывается непосредственный источник, цепочка автоматически не разворачивается. Получатель не получает доступ к исходному чату.
|
||||
|
||||
Для зашифрованных сообщений клиент расшифровывает оригинал локально, затем шифрует новое сообщение для актуального набора устройств назначения с новым `messageId`. Вложения нужно заново загрузить от текущего пользователя; для E2EE зашифровать их новыми ключами, а ключи поместить внутрь конверта. Прямая подстановка чужих media ID не даёт прав на файлы. Сервер не расшифровывает содержимое и не может проверить, что текст пересылки идентичен оригиналу; метаданные происхождения не являются подписью исходного автора под новым содержимым.
|
||||
|
||||
Повтор одного E2EE-запроса с тем же ID идемпотентен; изменение источника, адресата, содержимого, ответа или вложений с прежним ID отклоняется. В публичных чатах без E2EE каждый `Send` создаёт новое сообщение. Для массовой пересылки выполняйте отдельный вызов для каждого сообщения и адресата.
|
||||
|
||||
## Установка
|
||||
|
||||
Для полей происхождения пересылки требуется версия API с миграцией MessagingAndUserBenefits. [Порядок обновления](../operations.md).
|
||||
Reference in New Issue
Block a user