Files
Govor/docs/endpoints/friendshipcontroller.md
T
Artemy def724e0ee 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.
2026-10-31 18:35:50 +07:00

3.6 KiB
Raw Blame History

Друзья и поиск

Bearer token обязателен; отдельная роль в атрибуте не задана.

Метод Маршрут Результат
GET /api/friends UserDto[] друзей
GET /api/friends/search?query=Арт UserDto[] результатов поиска
[{
  "id":"11111111-1111-1111-1111-111111111111",
  "username":"Артём",
  "description":"",
  "wasOnline":"2026-10-03T00:00:00Z",
  "iconId":"00000000-0000-0000-0000-000000000000",
  "isOnline":false
}]

Пустой/пробельный query возвращает 400 строкой "Query cannot be empty". Успех — 200; серверные ошибки — 500 с объектом error. Не смешивайте UserDto и UserProfileDto: у второго нет wasOnline.

Изменение заявок выполняется через FriendsHub. HTTP-контроллер не содержит команды отправки, принятия и отклонения.

Статус isOnline зависит от состояния процесса и подключения к presence. Он не является гарантией доставки сообщений или фоновой доступности устройства.

Источник: 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. Только владелец может снять её; вторая сторона не может заменить владельца. Повтор собственной блокировки безопасен. Снятие блокировки не восстанавливает дружбу: требуется новая заявка и согласие получателя.