Files
Govor/docs/endpoints/private-chats.md
T
Artemy 632ac04b56 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.
2026-10-31 18:29:40 +07:00

1.8 KiB

Личные чаты

Требуется роль User/Admin.

Метод Маршрут Успех
GET /api/user/{friendId}/private-chat 200, Guid чата в JSON
GET /api/user/private-chats 200, PrivateChatDto[]

Первый метод проверяет дружбу, возвращает существующий чат либо создаёт новый. Это побочный эффект GET; рекомендуемый будущий контракт — POST, но маршрут пока не изменён.

[{
  "chatId":"11111111-1111-1111-1111-111111111111",
  "friendId":"22222222-2222-2222-2222-222222222222"
}]

При принятии заявки FriendRequestCommandService также создаёт личный чат. ChatsHub использует группы сессий; ручная подписка клиента на чат не требуется.

Используйте chatId в Send.recipientId и в /api/user/{userId}/messages. Несмотря на имя параметра userId, загрузчик ожидает ID PrivateChat.

Отсутствие дружбы/доступа возвращает 403 без обещания тела ProblemDetails. Некорректный аргумент — 400. При последовательном вызове существующий чат возвращается повторно. Сервис сначала ищет пару, затем создаёт запись; полную гарантию идемпотентности при конкурентном создании этот маршрут не обещает.

Источник: Govor.API/Controllers/PrivateChatController.cs.