GITBOOK-14: Govor.API: документация по текущему коду и диагностика 03.10.2026

This commit is contained in:
stalcke2288969
2026-10-03 06:20:45 +00:00
committed by gitbook-bot
parent 4603be9f71
commit 6c8abb23e3
27 changed files with 827 additions and 1901 deletions
+35
View File
@@ -0,0 +1,35 @@
# Администрирование и незавершённые группы
## Административные маршруты
Следующая таблица показывает фактические атрибуты, а не требуемую безопасную политику.
| Метод | Маршрут | Защита сейчас |
| ----- | ------------------------------------------------- | -------------------------------------- |
| POST | /api/admin/InviteUser/Invitation | Без Authorize |
| GET | /api/admin/InviteUser | Без Authorize |
| GET | /api/admin/InviteUser/GetAllActiveInvitations | Без Authorize |
| GET | /api/admin/InviteUser/{id} | Без Authorize |
| GET | /api/admin/Users/all | Любой аутентифицированный пользователь |
| GET | /api/admin/Users/{id} | Любой аутентифицированный пользователь |
| GET | /api/admin/Users/user/{id}/setpassword/{password} | Любой аутентифицированный пользователь |
CreateInvitationRequest: endDate, maxParticipants, isAdmin, description. Генератор возвращает строковый код в JSON (200). Списки приглашений возвращают id, description, isAdmin, maxParticipants, code, createdAt, endAt, isActive, participantCount.
Users/all фактически ограничен 50 записями без стабильной пагинации. Ответ UserResponse включает passwordHash, что недопустимо для клиентского контракта. Смена пароля выполняется GET и кладёт пароль в URL.
Эти маршруты нужно закрыть ролью Admin до публичного использования. Создание административного приглашения вместе с регистрацией позволяет получить роль Admin. Не подключайте их к пользовательскому интерфейсу.
## Группы
GET /invite/{code} задуман как вход в группу и требует Authorize. IGroupService не зарегистрирован в AddServices, а \_currentUser не присваивается. Маршрут не является рабочим сценарием вступления.
GroupsHub пуст и не подключён MapHub. Административный FriendshipsController содержит только закомментированные действия, поэтому рабочих endpoints у него нет.
Наличие моделей ChatGroup/GroupMembership/GroupInvitation и проверки участия в групповом Send не подтверждает готовый продуктовый сценарий групп и каналов.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/AdminStuff/UsersController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/AdminStuff/UsersController.cs).
+19 -32
View File
@@ -3,43 +3,30 @@ description: How to work with jwt tokens
icon: user
---
# Authentication
# Аутентификация
### <mark style="color:$info;">Components</mark>
## Последовательность
* **AuthController**: Handles registration and login.
* **Route**: `/api/auth`
* **RefreshController**: Manages token refresh.
* **Route**: `/api/auth/token`
1. `POST /api/auth/register` либо `POST /api/auth/login` возвращает `{ refreshToken, accessToken }`.
2. HTTP-запросы передают `Authorization: Bearer <accessToken>`.
3. Для SignalR задайте AccessTokenProvider, который возвращает актуальный access token. Program.cs также принимает query `access_token` на путях /hubs.
4. `POST /api/auth/token/refresh` возвращает новую пару; клиент сохраняет новый refresh token.
5. Отзыв сессий выполняется методами /api/Session/close.
### <mark style="color:$info;">Authentication Process</mark>
Access token содержит `userId`, `sid` и роль User/Admin. Подпись HS256 проверяется, срок проверяется, issuer и audience не проверяются. Токены возвращаются JSON; сервер не устанавливает HttpOnly-cookie.
* **Registration**:
* **Endpoint**: `POST /api/auth/register`
* **Input**: `RegistrationRequest` (name, password, inviteLink, deviceInfo)
* **Output**: Access token
* **Action**: Validates invite, registers user, opens session.
* **Login**:
* **Endpoint**: `POST /api/auth/login`
* **Input**: `LoginRequest` (name, password, deviceInfo)
* **Output**: Access token
* **Action**: Authenticates user, opens session.
* **Token Refresh**:
* **Endpoint**: `POST /api/auth/token/refresh`
* **Input**: `RefreshTokenRequest` (refreshToken)
* **Output**: `RefreshTokenResponse` (accessToken, refreshToken)
* **Action**: Refreshes expired access token.
## Ограничения реализации
### <mark style="color:$info;">Token Usage</mark>
Отзыв сессии блокирует refresh, но Program.cs не проверяет IsRevoked при каждом использовании access token. Уже открытые SignalR-соединения явно не разрываются. Немедленный logout на всех устройствах не гарантирован.
* **Access Token**:
* **Request**: Obtain during registration or login.
* **Refresh**: Request via `/api/auth/token/refresh` when expired (e.g., 02:12 PM CEST, July 21, 2025).
* **Refresh Token**:
* **Request**: Received during registration or login.
* **Refresh**: Use to obtain new access token when current one expires.
Refresh JWT содержит userId и tokenType, но не случайный jti или sid. При выпуске одному пользователю в одну секунду возможны одинаковые токены, конфликтующие с уникальным RefreshTokenHash. Ротация не защищена атомарным compare-and-swap от параллельных запросов.
### Security
Не используйте refresh token как access token. В bearer-валидации нет явного требования tokenType=access; методы с одним Authorize требуют исправления разделения типов токенов.
* **Protocol**: Requires HTTPS.
* **Storage**: Store refresh token in HTTP-only cookie with `Secure` and `SameSite=Strict`.
На MAUI рекомендовано хранить refresh token в SecureStorage и выполнять обновление последовательно. Это рекомендация клиенту, а не свойство сервера.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.Application/Authentication/JWT/JwtService.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Authentication/JWT/JwtService.cs).
+29 -118
View File
@@ -4,138 +4,49 @@ description: >-
and login, with session management and invite-based registration.
---
# AuthController
# Регистрация и вход
### Controller Description
Оба метода доступны анонимно, Content-Type: application/json.
* **Route**: `api/auth`
* **Authorize**: Allows anonymous access (`[AllowAnonymous]`).
## POST /api/auth/register
### Endpoints
```json
{
"name": "Артём",
"password": "example-password",
"inviteLink": "<код приглашения>",
"deviceInfo": "Android test device"
}
```
#### <mark style="color:$info;">Register</mark>
Имя: 4–44 символа, только кириллица и цифры, первый символ — буква. Модерация запрещает зарезервированные имена, совпадения/подстроки из конфигурации и пять одинаковых символов подряд. Пароль: минимум 8 символов. DeviceInfo необязателен в запросе, но в БД ограничен 256 символами.
* **Description**: Registers a new user using a valid invite link and opens a user session, returning an authentication token.
* **Route**: `[POST] api/auth/register`
* **HTTP Method**: `POST`
* **Request**:
* **Content-Type**: `application/json`
* **Request Body**: `RegistrationRequest` object with the following structure:
Код создаётся как Guid.ToString("N"): 32 символа без дефисов. Поиск кода — по строковому равенству. InviteLink — код, а не URL.
```json
{
"name": "string",
"password": "string",
"inviteLink": "string",
"deviceInfo": "string"
}
```
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns the authentication token upon successful registration and session creation.
Проверяется существование приглашения, срок и число участников. Проверка IsActive отсутствует, лимит участников не защищён от конкурентной регистрации.
```json
{
"refreshToken": "string",
"accessToken": "string"
}
```
* <mark style="color:$danger;">**400 Bad Request**</mark>:
* If model validation fails.
* If the user already exists: `"Registration failed: user already exists."`
* If the invite link is invalid: `"Invite link invalid."`
* If the username is invalid: `"Invalid username: <error_message>"`
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
Успех 200:
```json
"An unexpected error occurred. Please try again later."
```
```json
{"refreshToken":"<token>","accessToken":"<token>"}
```
#### <mark style="color:$info;">Login</mark>
Конфликт имени — 409; ошибки валидации — 400; отсутствующее приглашение — 404. Тело сервисных ошибок — ProblemDetails с errorCode. Регистрация и открытие сессии — отдельные сохранения: ошибка открытия сессии не откатывает созданного пользователя.
* **Description**: Authenticates an existing user and opens a session, returning an authentication token.
* **Route**: `[POST] api/auth/login`
* **HTTP Method**: `POST`
* **Request**:
* **Content-Type**: `application/json`
* **Request Body**: `LoginRequest` object with the following structure:
## POST /api/auth/login
```json
{
"name": "string",
"password": "string",
"deviceInfo": "string"
}
```
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns the authentication token upon successful login and session creation.
```json
{"name":"Артём","password":"example-password","deviceInfo":"Android test device"}
```
```json
{
"refreshToken": "string",
"accessToken": "string"
}
```
* <mark style="color:$danger;">**400 Bad Request**</mark>:
* If model validation fails.
* If the user does not exist: `"Login failed: user does not exist."`
* If the username or password is incorrect: `"Login failed: username or password is incorrect."`
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
Успех 200 с той же парой токенов. Пользователь не найден — 404 (UserNotRegisteredException); неверный пароль — 400 (InvalidOperationException). Это текущее поведение, а не рекомендуемая политика ошибок входа: разные ответы раскрывают существование аккаунта.
```json
"An unexpected error occurred. Please try again later."
```
## Ограничения
### Data Models
Rate limiting и блокировка перебора в Program.cs не настроены. Для публичного запуска нужны единая ошибка входа, ограничение частоты и защита административных приглашений.
#### RegistrationRequest
***
* **Description**: Model for registration request data.
* **Structure**:
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
{
"name": "string",
"password": "string",
"inviteLink": "string",
"deviceInfo": "string"
}
```
#### LoginRequest
* **Description**: Model for login request data.
* **Structure**:
```json
{
"name": "string",
"password": "string",
"deviceInfo": "string"
}
```
#### RefreshResult
* **Description**: Model for refresh token response data.
* **Structure**:
```json
{
"refreshToken": "string",
"accessToken": "string"
}
```
### Error Handling
* **Invalid User ID**: Not applicable (handled by session service).
* **Invalid Operations**: Registration fails if the user already exists, invite link is invalid, or username is invalid, returning `400 Bad Request`.
* **Unauthorized Access**: Not applicable (endpoint is `[AllowAnonymous]`).
* **Unexpected Errors**: General exceptions are caught, logged, and returned as `500 Internal Server Error`.
### Logging
* Logs successful registration and login events with username and user ID.
* Logs session opening events with username and user ID.
* Logs warnings for specific exceptions (e.g., user already exists, invalid invite link, login failures).
* Logs errors for unexpected exceptions during registration and login.
Источник: [Govor.API/Controllers/Authentication/AuthController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Authentication/AuthController.cs).
@@ -4,87 +4,40 @@ description: >-
their access tokens using a valid refresh token.
---
# RefreshController
# Обновление токенов
### Controller Description
## POST /api/auth/token/refresh
* **Route**: `api/auth/token`
* **Authorize**: Allows anonymous access (`[AllowAnonymous]`).
Доступ анонимный. JSON:
### Endpoints
```json
{"refreshToken":"<последний сохранённый refresh token>"}
```
#### <mark style="color:$info;">Refresh</mark>
Сервис хеширует переданную строку и ищет UserSession по RefreshTokenHash. Проверяет IsRevoked и ExpiresAt, выпускает новую пару, заменяет хеш и продлевает ExpiresAt. CreatedAt также перезаписывается, поэтому после refresh это не исходная дата открытия сессии.
* **Description**: Refreshes an access token using a provided refresh token and returns a new access token and refresh token pair.
* **Route**: `[POST] api/auth/token/refresh`
* **HTTP Method**: `POST`
* **Request**:
* **Content-Type**: `application/json`
* **Request Body**: `RefreshTokenRequest` object with the following structure:
Успех 200:
```json
{
"refreshToken": "string"
}
```
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a new access token and refresh token upon successful refresh.
```json
{"refreshToken":"<new token>","accessToken":"<new token>"}
```
```json
{
"accessToken": "string",
"refreshToken": "string"
}
```
* <mark style="color:$warning;">**400 Bad Request**</mark>: If model validation fails or the refresh token is empty.
| Случай | Текущий ответ |
| -------------------------- | -------------------------------- |
| Пустая строка | 400, errorCode Auth.EmptyToken |
| Хеш не найден | 400, errorCode Auth.InvalidToken |
| Истекшая/отозванная сессия | 400, errorCode Auth.InvalidToken |
```json
"Refresh token cant be empty."
```
* <mark style="color:$warning;">**401 Unauthorized**</mark>: If the refresh token is invalid or authorization fails.
Не документируйте неверный refresh как гарантированный 401: текущий Error.Failure преобразуется в 400.
```json
"Invalid refresh token"
```
* <mark style="color:$danger;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
## Клиент
```json
"An unexpected error occurred."
```
Сохраните оба новых токена и сериализуйте refresh-запросы. Ошибка сети не должна автоматически удалять авторизацию пользователя. При подтверждённо недействительном refresh требуется повторный вход.
### Data Models
Ротация сейчас не имеет защиты от конкурентного использования и истории повторного применения. Детали — в разделе «Аутентификация».
#### RefreshTokenRequest
***
* **Description**: Model for refresh token request data.
* **Structure**:
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
{
"refreshToken": "string"
}
```
#### RefreshTokenResponse
* **Description**: Model for refresh token response data.
* **Structure**:
```json
{
"accessToken": "string",
"refreshToken": "string"
}
```
### Error Handling
* **Invalid User ID**: Not applicable (handled by session service).
* **Invalid Operations**: Returns `400 Bad Request` if the refresh token is empty or invalid.
* **Unauthorized Access**: Returns `401 Unauthorized` if the refresh token fails authorization.
* **Unexpected Errors**: General exceptions are caught, logged, and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for invalid or failed refresh token attempts.
* Logs errors for unexpected exceptions during token refresh.
Источник: [Govor.Application/Users/UserSessions/UserSessionRefresher.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Users/UserSessions/UserSessionRefresher.cs).
@@ -0,0 +1,33 @@
# Ключи сессий — экспериментальный API
RequireHttps и роль User/Admin обязательны.
| Метод | Маршрут | Назначение |
| ----- | --------------------------------- | ---------------------------------------- |
| POST | /api/session/keys | Привязать публичные ключи текущей сессии |
| GET | /api/session/users/{userId}/keys | Получить ключи друга |
| POST | /api/session/keys/rotate | Пополнить одноразовые ключи |
| GET | /api/session/keys/remaining | { remaining: число } |
| POST | /api/session/keys/{preKeyId}/used | Пометить собственный ключ использованным |
byte\[] в JSON передаются строкой base64. UploadKeysRequest содержит identityKey, signedPreKey, signedPreKeySignature и oneTimePreKeys (массив base64). За запрос допускается максимум 100 одноразовых ключей. Сервис запрещает повторную привязку ключей к сессии и проверяет владельца.
RotateOneTimePreKeysRequest содержит newOneTimePreKeys. В реализации ротация удаляет использованные записи и добавляет новые, не ограничивая общий размер набора.
## Неработающие и небезопасные части
\_oneTimePreKeysRotator не передан в конструктор SessionKeysController: rotate и used падают при обращении к null.
remaining считает все записи, включая IsUsed. Reader выдаёт все OneTimePreKeys и возвращает EF-сущности UserCryptoSession вместо PublicSessionKeysDto. Include(UserSession) может включить внутренние поля, а двусторонние навигации могут привести к циклу сериализации. SignedPreKey не включён явным Include.
Доступ к чужим ключам ограничен дружбой, но Forbid("текст") ошибочно используется как имя authentication scheme. Атомарной выдачи одного неиспользованного prekey потребителю нет: endpoint used относится к текущей сессии владельца.
## Статус E2EE
Это заготовка хранения ключей, не законченный криптографический протокол. Нет доказанной реализации обмена/проверки подписей, одноразового потребления, ratchet и поддержки шифрования на клиенте. Не используйте этот раздел как обещание сквозного шифрования.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/Authentication/SessionKeysController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Authentication/SessionKeysController.cs).
+32 -242
View File
@@ -2,258 +2,48 @@
description: Controller for loading chat messages for users and groups with pagination.
---
# ChatLoadController
# История сообщений
### Controller Description
Требуется роль User/Admin.
* **Route**: `api/chats`
* **Authorize**: Requires authenticated user with roles "Admin" or "User" (`[Authorize(Roles = "Admin, User")]`).
| Метод | Маршрут | Идентификатор |
| ----- | ------------------------------ | -------------------------------------- |
| GET | /api/user/{userId}/messages | В userId передаётся **ID PrivateChat** |
| GET | /api/groups/{groupId}/messages | ID ChatGroup |
### Endpoints
Query: StartMessageId (Guid?, необязателен), Before=20, After=2. Before и After неотрицательные, сумма ≤100.
#### <mark style="color:$info;">GetGroupMessages</mark>
Без StartMessageId возвращаются последние Before сообщений, упорядоченные по SentAt по возрастанию; After не используется. С якорем возвращаются Before старых, якорное сообщение и After новых: максимум 101 запись. Неизвестный якорь — \[].
* **Description**: Retrieves messages from a specified group chat with pagination.
* **Route**: `[GET] api/chats/group-messages`
* **HTTP Method**: `GET`
* **Request**:
* **Path Parameter**: `chatId` (Guid, required): ID of the group chat.
* **Query Parameter**: `query` (`MessageQuery`, required) with:
* `startMessageId` (Guid?, optional): ID of the starting message.
* `before` (int, default=20): Number of messages before the start.
* `after` (int, default=2): Number of messages after the start.
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of group chat messages.
Успех 200, MessageResponse\[]:
```json
[
{
"id": "Guid",
"senderId": "Guid",
"recipientId": "Guid",
"recipientType": "string",
"encryptedContent": "string",
"sentAt": "DateTime",
"isEdited": "boolean",
"editedAt": "DateTime?",
"replyToMessageId": "Guid?",
"mediaAttachments": [
{
"id": "Guid",
"messageId": "Guid",
"mediaFileId": "Guid"
}
],
"reactions": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"reactionCode": "string",
"reactedAt": "DateTime"
}
],
"messageViews": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"viewedAt": "DateTime"
}
]
}
]
```
* <mark style="color:$danger;">**400 Bad Request**</mark>:
* If `before` or `after` is negative or total exceeds 100: `"Values must be non-negative and total must not exceed 100."`
* If an argument or resource is invalid: `"string"`
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
[{
"id":"11111111-1111-1111-1111-111111111111",
"senderId":"22222222-2222-2222-2222-222222222222",
"recipientId":"33333333-3333-3333-3333-333333333333",
"recipientType":0,
"encryptedContent":"<строка>",
"sentAt":"2026-10-03T00:00:00Z",
"isEdited":false,
"editedAt":null,
"replyToMessageId":null,
"mediaAttachments":[],
"reactions":[],
"messageViews":[]
}]
```
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
У HTTP-ответа поле id; у SignalR UserMessageResponse — messageId. Вложения HTTP имеют id, messageId, mediaFileId.
```json
"Unexpected Error! Please try again later."
```
## Известные проблемы
#### <mark style="color:$info;">GetUserMessages</mark>
Личный загрузчик принимает currentUser, но не проверяет участие в указанном чате. Это критичная ошибка доступа. Для группы участие проверяется; неучастнику возвращается \[].
* **Description**: Retrieves messages from a specified user chat with pagination.
* **Route**: `[GET] api/chats/user-messages`
* **HTTP Method**: `GET`
* **Request**:
* **Path Parameter**: `userId` (Guid, required): ID of the target user.
* **Query Parameter**: `query` (`MessageQuery`, required) with:
* `startMessageId` (Guid?, optional): ID of the starting message.
* `before` (int, default=20): Number of messages before the start.
* `after` (int, default=2): Number of messages after the start.
* **Responses**:
* **200 OK**: Returns a list of user chat messages.
Пагинация сравнивает только SentAt: сообщения с одинаковой датой могут выпадать вокруг якоря. Reactions и MessageViews не включаются явным Include, поэтому эти массивы не являются надёжным источником состояния. Нужны проверки доступа и стабильный курсор (SentAt, Id).
```json
[
{
"id": "Guid",
"senderId": "Guid",
"recipientId": "Guid",
"recipientType": "string",
"encryptedContent": "string",
"sentAt": "DateTime",
"isEdited": "boolean",
"editedAt": "DateTime?",
"replyToMessageId": "Guid?",
"mediaAttachments": [
{
"id": "Guid",
"messageId": "Guid",
"mediaFileId": "Guid"
}
],
"reactions": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"reactionCode": "string",
"reactedAt": "DateTime"
}
],
"messageViews": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"viewedAt": "DateTime"
}
]
}
]
```
* **400 Bad Request**:
* If `before` or `after` is negative or total exceeds 100: `"Values must be non-negative and total must not exceed 100."`
* If an operation or resource is invalid: `"string"`
* **403 Forbidden**: If user lacks authorization.
***
```json
"string"
```
* **500 Internal Server Error**: Indicates an unexpected error.
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
"Unexpected Error! Please try again later."
```
### Data Models
#### MessageQuery
* **Description**: Model for pagination query parameters.
* **Structure**:
```json
{
"startMessageId": "Guid?",
"before": "int",
"after": "int"
}
```
#### MessageResponse
* **Description**: Data transfer object for chat message details.
* **Structure**:
```json
{
"id": "Guid",
"senderId": "Guid",
"recipientId": "Guid",
"recipientType": "string",
"encryptedContent": "string",
"sentAt": "DateTime",
"isEdited": "boolean",
"editedAt": "DateTime?",
"replyToMessageId": "Guid?",
"mediaAttachments": [
{
"id": "Guid",
"messageId": "Guid",
"mediaFileId": "Guid"
}
],
"reactions": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"reactionCode": "string",
"reactedAt": "DateTime"
}
],
"messageViews": [
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"viewedAt": "DateTime"
}
]
}
```
#### MediaAttachmentResponse
* **Description**: Data transfer object for media attachments in messages.
* **Structure**:
```json
{
"id": "Guid",
"messageId": "Guid",
"mediaFileId": "Guid"
}
```
#### MessageReactionResponse
* **Description**: Data transfer object for message reactions.
* **Structure**:
```json
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"reactionCode": "string",
"reactedAt": "DateTime"
}
```
#### MessageViewResponse
* **Description**: Data transfer object for message view tracking.
* **Structure**:
```json
{
"id": "Guid",
"messageId": "Guid",
"userId": "Guid",
"viewedAt": "DateTime"
}
```
### Error Handling
* **Invalid User ID**: Handled by `ICurrentUserService`, aborts if invalid.
* **Invalid Operations**: Returns `400 Bad Request` for negative values, total exceeding 100, or `InvalidOperationException`.
* **Unauthorized Access**: Returns `403 Forbidden` for `UnauthorizedAccessException`.
* **Resource Not Found**: Returns `400 Bad Request` for `NotFoundException`.
* **Unexpected Errors**: Caught and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for `UnauthorizedAccessException`, `NotFoundException`, `ArgumentException`, and `InvalidOperationException`.
* Logs errors for unexpected exceptions.
Источник: [Govor.Application/Messages/MessagesLoader.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.Application/Messages/MessagesLoader.cs).
+22 -99
View File
@@ -4,111 +4,34 @@ description: >-
searching for users and retrieving the list of friends for the current user.
---
# FriendshipController
# Друзья и поиск
### Controller Description
Bearer token обязателен; отдельная роль в атрибуте не задана.
* **Route**: `api/friends`
* **Authorize**: Requires authenticated user (`[Authorize]`).
| Метод | Маршрут | Результат |
| ----- | ----------------------------- | ----------------------------- |
| GET | /api/friends | UserDto\[] друзей |
| GET | /api/friends/search?query=Арт | UserDto\[] результатов поиска |
### Endpoints
```json
[{
"id":"11111111-1111-1111-1111-111111111111",
"username":"Артём",
"description":"",
"wasOnline":"2026-10-03T00:00:00Z",
"iconId":"00000000-0000-0000-0000-000000000000",
"isOnline":false
}]
```
#### <mark style="color:$info;">Search</mark>
Пустой/пробельный query возвращает 400 строкой "Query cannot be empty". Успех — 200; серверные ошибки — 500 с объектом error. Не смешивайте UserDto и UserProfileDto: у второго нет wasOnline.
* **Description**: Searches for users based on a query string.
* **Route**: `[GET] api/friends/search?query=`
* **HTTP Method**: `GET`
* **Request**:
* **Query Parameter**: `query` (string, required)
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of matching users.
Изменение заявок выполняется через FriendsHub. HTTP-контроллер не содержит команды отправки, принятия и отклонения.
```json
[
{
"id": "Guid",
"username": "string",
"description": "string",
"wasOnline": "DateTime",
"iconId": "Guid"
}
]
```
* <mark style="color:$danger;">**400 Bad Request**</mark>: If the query is empty.
Статус isOnline зависит от состояния процесса и подключения к presence. Он не является гарантией доставки сообщений или фоновой доступности устройства.
```json
"Query cannot be empty"
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
***
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
{
"error": "Internal error during user search."
}
```
#### <mark style="color:$info;">GetFriends</mark>
* **Description**: Retrieves the list of friends for the authenticated user.
* **Route**: `[GET] api/friends`
* **HTTP Method**: `GET`
* **Request**: None
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of the user's friends or an empty list if none.
```json
[
{
"id": "Guid",
"username": "string",
"description": "string",
"wasOnline": "DateTime",
"iconId": "Guid"
}
]
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
```json
{
"error": "Internal server error."
}
```
### Data Models
#### UserDto
* **Description**: Data transfer object for user information.
* **Structure**:
```json
{
"id": "Guid",
"username": "string",
"description": "string",
"wasOnline": "DateTime",
"iconId": "Guid"
}
```
### Error Handling
* **Invalid User ID**: Handled by `ICurrentUserService`, aborts if invalid.
* **Invalid Operations**: Returns `400 Bad Request` for empty query.
* **Unexpected Errors**: Caught and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for `SearchUsersException`.
* Logs errors for unexpected exceptions and `InvalidOperationException`.
Источник: [Govor.API/Controllers/Friends/FriendshipController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Friends/FriendshipController.cs).
+19 -95
View File
@@ -4,106 +4,30 @@ description: >-
incoming friend requests and responses to sent friend requests.
---
# FriendsRequestQueryController
# Списки заявок в друзья
### Controller Description
Оба маршрута требуют Bearer token и возвращают 200 с FriendshipDto\[].
* **Route**: `api/friends`
* **Authorize**: Requires authenticated user (`[Authorize]`).
| Метод | Маршрут | Назначение |
| ----- | ---------------------- | --------------------------------------------------------------------- |
| GET | /api/friends/requests | Входящие заявки |
| GET | /api/friends/responses | Исходящие записи, кроме Accepted (включая Pending, Rejected, Blocked) |
### Endpoints
```json
[{
"id":"11111111-1111-1111-1111-111111111111",
"requesterId":"22222222-2222-2222-2222-222222222222",
"addresseeId":"33333333-3333-3333-3333-333333333333",
"status":0
}]
```
#### <mark style="color:$info;">GetIncomingRequests</mark>
FriendshipStatus сериализуется числом: Pending=0, Accepted=1, Rejected=2, Blocked=3. id — идентификатор заявки/дружбы; именно он передаётся в AcceptRequest и RejectRequest.
* **Description**: Retrieves a list of incoming friend requests for the authenticated user.
* **Route**: `[GET] api/friends/requests`
* **HTTP Method**: `GET`
* **Request**: None
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of incoming friend requests or an empty list if none.
При отсутствии записей — пустой массив. Ошибки контроллера — 500 с {"error":"Internal server error."}. Для восстановления после reconnect перечитайте списки: события не являются журналом гарантированной доставки.
```json
[
{
"id": "Guid",
"senderId": "Guid",
"receiverId": "Guid",
"status": "string",
"createdAt": "DateTime"
}
]
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
***
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
{
"error": "Internal server error."
}
```
#### <mark style="color:$info;">GetResponses</mark>
* **Description**: Retrieves a list of responses to the authenticated user's sent friend requests.
* **Route**: `[GET] api/friends/responses`
* **HTTP Method**: `GET`
* **Request**: None
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of friend request responses or an empty list if none.
```json
[
{
"id": "Guid",
"senderId": "Guid",
"receiverId": "Guid",
"status": "string",
"createdAt": "DateTime"
}
]
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
```json
{
"error": "Internal server error."
}
```
### Data Models
#### FriendshipDto
* **Description**: Data transfer object for friend request information.
* **Structure**:
```json
{
"id": "Guid",
"senderId": "Guid",
"receiverId": "Guid",
"status": "string",
"createdAt": "DateTime"
}
```
### Error Handling
* **Invalid User ID**: Handled by `ICurrentUserService`, aborts if invalid.
* **Invalid Operations**: Returns `200 OK` with an empty list for `InvalidOperationException`.
* **Unexpected Errors**: Caught and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for `InvalidOperationException`.
* Logs information for successful response retrieval.
* Logs errors for unexpected exceptions.
Источник: [Govor.API/Controllers/Friends/FriendsRequestQueryController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/Friends/FriendsRequestQueryController.cs).
+26 -86
View File
@@ -2,106 +2,46 @@
description: Controller for uploading and downloading media files.
---
# MediaController
# Медиа
### Controller Description
Требуется роль User/Admin.
* **Route**: `api/media`
* **Authorize**: Requires authenticated user with roles "User" or "Admin" (`[Authorize(Roles = "User,Admin")]`).
## POST /api/media/upload
### Endpoints
Content-Type: multipart/form-data. Поля:
#### <mark style="color:$info;">Upload</mark>
| Поле | Тип | Назначение |
| ------------ | ----------- | ---------------------------------------------------------- |
| FromFile | файл | Непустое содержимое |
| Type | число | Image=0, Video=1, Audio=2, File=3, Voice=4 |
| MimeType | строка ≤255 | MIME типа файла |
| EncryptedKey | строка | Обязательное поле запроса; сохранение ключа не реализовано |
| OwnerType | число | Message=0, Avatar=1, GroupAvatar=2, System=3 |
* **Description**: Uploads a media file with associated metadata.
* **Route**: `[POST] api/media/upload`
* **HTTP Method**: `POST`
* **Request**:
* **Content-Type**: `multipart/form-data`
* **Request Body**: `MediaUploadRequest` object with the following structure:
Ограничение запроса — 20 000 000 байт, включая multipart; проверка файла также ≤20 000 000. Не следует обещать загрузку файла ровно этого размера: overhead тоже входит в лимит.
```json
{
"fromFile": "IFormFile",
"type": "MediaType",
"mimeType": "string",
"encryptedKey": "string"
}
```
* **Constraints**: File size limit of 20 MB.
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns the upload result.
Успех 200:
```json
"string" // Media ID or similar result
```
* <mark style="color:$danger;">**400 Bad Request**</mark>:
* If model validation fails.
* If no file is uploaded: `"No file uploaded"`
* If file exceeds 20 MB: `"File is too large"`
* If MIME type is missing: `"Missing MIME type"`
* If operation is invalid: `"string"`
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
{"mediaId":"11111111-1111-1111-1111-111111111111","url":"2026/10/<имя файла>"}
```
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
url — относительный путь хранилища, не публичный URL. Для скачивания используйте endpoint.
```json
"Internal server error"
```
## GET /api/media/download/{id}
#### <mark style="color:$info;">Download</mark>
Проверяет HasAccessAsync, затем возвращает бинарный файл с MIME и Content-Disposition. Если доступа нет или запись не найдена — 403, потому что проверка доступа выполняется первой. Сервисные ошибки — через ResultExtensions.
* **Description**: Downloads a media file by its ID.
* **Route**: `[GET] api/media/download/{id}`
* **HTTP Method**: `GET`
* **Request**:
* **Path Parameter**: `id` (Guid, required): ID of the media file.
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns the media file as a stream.
* **Content-Type**: Matches `MimeType` of the media.
* **Content-Disposition**: Includes `filename` from `FileName`.
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks access.
* No body.
* <mark style="color:$danger;">**404 Not Found**</mark>: If media is not found.
## Ограничения
```json
"Media not found"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
Для личного сообщения accesser сравнивает Message.RecipientId с userId, хотя там ID чата: получатель может получить 403. При Send принадлежность вложения загрузившему пользователю не проверяется. OwnerType задаёт клиент, включая публично доступный System, — нужна серверная политика владения.
```json
"Internal server error"
```
EncryptedKey не хранится ни в MediaFile, ни в MediaAttachments. Нельзя обещать восстановление ключа из истории.
### Data Models
Файлы целиком буферизуются в памяти, MIME принимается от клиента. Запись файла и БД не атомарна: возможны файлы без записи. Очистка неиспользуемых загрузок и stream-based выдача требуют реализации.
#### MediaUploadRequest
***
* **Description**: Model for media upload request data.
* **Structure**:
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
{
"fromFile": "IFormFile",
"type": "MediaType",
"mimeType": "string",
"encryptedKey": "string"
}
```
### Error Handling
* **Invalid User ID**: Handled by `ICurrentUserService`, aborts if invalid.
* **Invalid Operations**: Returns `400 Bad Request` for `InvalidOperationException`.
* **Unauthorized Access**: Returns `403 Forbidden` for `UnauthorizedAccessException`.
* **Resource Not Found**: Returns `404 Not Found` for `KeyNotFoundException`.
* **Unexpected Errors**: Caught and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for `UnauthorizedAccessException`, `InvalidOperationException`, and `KeyNotFoundException`.
* Logs information for successful file uploads.
* Logs errors for unexpected exceptions during upload and download.
Источник: [Govor.API/Controllers/MediaController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/MediaController.cs).
@@ -4,47 +4,23 @@ description: >-
ping requests.
---
# OnlinePingingController(не работает)
# HTTP-присутствие — ограничения
**Route**: `api/online`\
**Authorize**: Requires "User" or "Admin" role
Требуется роль User/Admin.
### <mark style="color:purple;">End Point {PATCH}</mark>
| Метод | Маршрут | Текущее поведение |
| ----- | --------------------------- | ----------------------------------------------- |
| PATCH | /api/online/ping | Вызывает PingHandlerService, успех 200 без тела |
| GET | /api/online/status/{userId} | Неработоспособен: 500 |
`[PATCH] api/online/ping`
В конструкторе не присваиваются \_userOnlineStore и \_presenceReader. GetStatus обращается к null; catch возвращает 500 "Internal server error.".
#### Description
Задуманное тело status — { isOnline, lastSeen }, но сейчас его нельзя считать рабочим контрактом.
Updates the online status of the current user by sending a ping request.
Для событий online/offline подключайтесь к /hubs/presence. Ping и наличие SignalR-подключения — разные механизмы; требуется единая политика lastSeen/TTL. Не считайте HTTP ping подтверждением активного presence-соединения.
**Request**
***
* **Content-Type**: `application/json`
* **Request Body**: None
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
**Responses**
* **200 OK**: Ping processed successfully.
```json
{}
```
* **400 Bad Request**: If the user cannot be found in the database.
```json
"User can't be found in our database."
```
* **403 Forbidden**: If the user is not authorized to perform the action.
```json
{
"error": "Not authorized to perform this action."
}
```
* **500 Internal Server Error**: Indicates an unexpected error.
```json
{
"error": "Failed to send friend request."
}
```
Источник: [Govor.API/Controllers/OnlinePingingController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/OnlinePingingController.cs).
+29
View File
@@ -0,0 +1,29 @@
# Личные чаты
Требуется роль 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).
+29
View File
@@ -0,0 +1,29 @@
# Профиль и аватар
Требуется роль User/Admin.
| Метод | Маршрут | Успех |
| ----- | -------------------------- | ------------------------------------------- |
| GET | /api/profile/download/me | 200, UserProfileDto текущего пользователя |
| GET | /api/profile/download/{id} | 200, UserProfileDto указанного пользователя |
| POST | /api/profile/avatar | 200, MediaUploadResult |
UserProfileDto: id, username, description (nullable), iconId (nullable), isOnline. Отсутствующий пользователь — 404 ProblemDetails.
Загрузка аватара: multipart/form-data с FromFile, Type, MimeType. В отличие от MediaController, отдельный лимит 20 MB не задан; действуют ограничения хоста. Контроллер сохраняет медиа с OwnerType.Avatar и устанавливает IconId.
Описание изменяется через ProfileHub.SetDescription. ProfileHub.SetAvatar принимает существующий iconId и рассылает AvatarUpdated.
## Ограничения
REST UploadAvatar не рассылает AvatarUpdated. Клиентам может потребоваться отдельное обновление данных. В ProfileHub.SetAvatar проверяется существование файла, но не его загрузчик/тип/владелец.
Хаб игнорирует Result от SetDescription и SetNewIcon, поэтому успех true не всегда подтверждает изменение. MappingProfile дважды регистрирует UserProfile → UserProfileDto; это нужно устранить и проверить isOnline.
Чтение чужого профиля не применяет PrivacyUserSettings. Наличие моделей приватности не означает действующую политику доступа.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Controllers/ProfileController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/ProfileController.cs).
+29
View File
@@ -0,0 +1,29 @@
# Push-уведомления
## POST /api/pushes/token/register
Требуется роль User/Admin. JSON:
```json
{"token":"<FCM registration token>","platform":"Android"}
```
Сервис связывает токен с userId и sid текущего access token, добавляет или обновляет запись. Успех Unit — 204. Пустой token/platform отклоняется 400; тело BadRequest(ModelState) не всегда содержит полезное объяснение.
При отзыве сессии связанные токены деактивируются. В DI зарегистрирован FirebasePushProvider; credentials читаются при старте приложения.
## Отправка
Личные сообщения вызывают отправку push собеседнику. title — имя отправителя; body — первые 40 символов EncryptedContent. Data содержит chatId и isGroup ("false"). Это текущая реализация: сервер не расшифровывает содержимое.
Для E2EE тело push должно быть нейтральным. Для текущего MAUI, отправляющего обычный текст, этот body раскрывает превью сообщения внешнему push-провайдеру.
## Доставка
Сохранение сообщения, SignalR и Firebase не образуют единую транзакцию. Ошибка после SaveChanges может дать ошибку Send, хотя сообщение уже записано. Автоматическое повторение без идентификатора клиентской операции может создать дубль. Нужны outbox, дедупликация и обработка недействительных FCM-токенов.
***
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
Источник: [Govor.API/Hubs/Infrastructure/ChatNotificationService.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Hubs/Infrastructure/ChatNotificationService.cs).
+25 -140
View File
@@ -4,154 +4,39 @@ description: >-
sessions.
---
# SessionController
# Сессии
### Controller Description
Все методы требуют Bearer access token с ролью User или Admin.
* **Route**: `api/session`
* **Authorize**: Requires authenticated user with roles "Admin" or "User" (`[Authorize(Roles = "Admin,User")]`).
| Метод | Маршрут | Успех |
| ------ | ------------------------------ | ------------------------------------ |
| GET | /api/Session/all | 200, SessionDto\[] |
| DELETE | /api/Session/close/{sessionId} | 204, без тела |
| DELETE | /api/Session/close | 204, закрыть sid текущего токена |
| DELETE | /api/Session/close/all | 204, закрыть все сессии пользователя |
### Endpoints
```json
[{
"id":"11111111-1111-1111-1111-111111111111",
"deviceInfo":"Android test device",
"createdAt":"2026-10-03T00:00:00Z",
"expiresAt":"2026-10-10T00:00:00Z",
"isRevoked":false
}]
```
#### <mark style="color:$info;">GetAllSessions</mark>
Список фильтруется по UserId и !IsRevoked, но не по ExpiresAt; истекшие сессии могут присутствовать. CreatedAt меняется при refresh.
* **Description**: Retrieves all active sessions for the authenticated user.
* **Route**: `[GET] api/session/all`
* **HTTP Method**: `GET`
* **Request**: None
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Returns a list of user sessions.
Закрытие чужой, неизвестной или уже отозванной сессии возвращает 404 с errorCode UserSession.NotFoundOrUnauthorized. Guid.Empty возвращает 400. CloseAll без активных сессий тоже успешен.
```json
[
{
"id": "Guid",
"deviceInfo": "string",
"createdAt": "DateTime",
"expiresAt": "DateTime",
"isRevoked": "boolean"
}
]
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
Отзыв деактивирует связанные push-токены. Успех Unit преобразуется в 204, а не в 200.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
## Ограничение logout
```json
"Unexpected Error! Please try again later."
```
IsRevoked проверяется при refresh; bearer middleware не сверяет текущий sid с БД. Access token может работать до окончания срока, а существующее соединение SignalR не закрывается этим контроллером.
#### <mark style="color:$info;">CloseSession</mark>
***
* **Description**: Closes a specific session for the authenticated user.
* **Route**: `[DELETE] api/session/close/{sessionId}`
* **HTTP Method**: `DELETE`
* **Request**:
* **Path Parameter**: `sessionId` (Guid, required): ID of the session to close.
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Indicates session was successfully closed.
* No body.
* <mark style="color:$danger;">**400 Bad Request**</mark>: If `sessionId` is invalid or operation fails.
Проверено по исходникам на 03.10.2026, commit `4603be9`. Описано текущее поведение; успешная сборка не означает проверку работающего сервера.
```json
"string"
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
"string"
```
* <mark style="color:$danger;">**404 Not Found**</mark>: If session is not found.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
```json
"Unexpected Error! Please try again later."
```
#### <mark style="color:$info;">CloseSession</mark>
* **Description**: Closes a current session for the authenticated user.
* **Route**: `[DELETE] api/session/close/`
* **HTTP Method**: `DELETE`
* **Request**:
* No body.
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Indicates session was successfully closed.
* No body.
* <mark style="color:$danger;">**400 Bad Request**</mark>: If `sessionId` is invalid or operation fails.
```json
"string"
```
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
"string"
```
* <mark style="color:$danger;">**404 Not Found**</mark>: If session is not found.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
```json
"Unexpected Error! Please try again later."
```
#### <mark style="color:$info;">CloseAllSessions</mark>
* **Description**: Closes all active sessions for the authenticated user.
* **Route**: `[DELETE] api/session/close/all`
* **HTTP Method**: `DELETE`
* **Request**: None
* **Responses**:
* <mark style="color:$success;">**200 OK**</mark>: Indicates all sessions were successfully closed.
* No body.
* <mark style="color:$danger;">**403 Forbidden**</mark>: If user lacks authorization.
```json
"string"
```
* <mark style="color:$warning;">**500 Internal Server Error**</mark>: Indicates an unexpected error.
```json
"Unexpected Error! Please try again later."
```
### Data Models
#### SessionDto
* **Description**: Data transfer object for session information.
* **Structure**:
```json
{
"id": "Guid",
"deviceInfo": "string",
"createdAt": "DateTime",
"expiresAt": "DateTime",
"isRevoked": "boolean"
}
```
### Error Handling
* **Invalid User ID**: Handled by `ICurrentUserService`, aborts if invalid.
* **Invalid Operations**: Returns `400 Bad Request` for `InvalidOperationException`.
* **Unauthorized Access**: Returns `403 Forbidden` for `UnauthorizedAccessException`.
* **Resource Not Found**: Returns `404 Not Found` for `NotFoundException`.
* **Unexpected Errors**: Caught and returned as `500 Internal Server Error`.
### Logging
* Logs warnings for `UnauthorizedAccessException` and `NotFoundException`.
* Logs errors for `InvalidOperationException` and unexpected exceptions.
Источник: [Govor.API/Controllers/SessionController.cs](https://github.com/Govor-team/Govor/blob/4603be9f714135e0af72d505d17f3d1709834bea/Govor.API/Controllers/SessionController.cs).