mirror of
https://github.com/Govor-team/Govor.git
synced 2026-11-19 21:46:08 +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`. Только владелец может снять её; вторая сторона не может заменить владельца. Повтор собственной блокировки безопасен. Снятие блокировки не восстанавливает дружбу: требуется новая заявка и согласие получателя.
|
||||
|
||||
Reference in New Issue
Block a user