Files
Govor/docs/endpoints/private-chats.md
T

30 lines
2.0 KiB
Markdown

# Личные чаты
Требуется роль User/Admin.
| Метод | Маршрут | Успех |
| ----- | --------------------------------- | ---------------------- |
| GET | /api/user/{friendId}/private-chat | 200, Guid чата в JSON |
| GET | /api/user/private-chats | 200, PrivateChatDto\[] |
Первый метод проверяет дружбу, возвращает существующий чат либо создаёт новый. Это побочный эффект GET; рекомендуемый будущий контракт — POST, но маршрут пока не изменён.
```json
[{
"chatId":"11111111-1111-1111-1111-111111111111",
"friendId":"22222222-2222-2222-2222-222222222222"
}]
```
При принятии заявки FriendRequestCommandService также создаёт личный чат и добавляет текущие соединения участников в SignalR-группу.
Используйте chatId в Send.recipientId и в /api/user/{userId}/messages. Несмотря на имя параметра userId, загрузчик ожидает ID PrivateChat.
Ошибки дружбы передаются через Forbid(ex.Message), что ошибочно трактует сообщение как имя схемы аутентификации и может дать 500. Параллельное создание и повторное присоединение после частичного сбоя требуют отдельной проверки.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/PrivateChatController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/PrivateChatController.cs).