> For the complete documentation index, see [llms.txt](https://nas-3.gitbook.io/govor-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nas-3.gitbook.io/govor-api/readme.md).

# Govor — документация сервера

Govor — мессенджер с сервером ASP.NET Core и отдельным клиентом .NET MAUI. Здесь описаны запуск сервера, HTTP API, SignalR, шифрование, восстановление доступа и эксплуатация.

Документация сверена с серверным `master`, коммит `a3401ce`, 30 октября 2026 года. Описанное поведение относится к этой версии; установленный сервер может быть старше. Адреса и секреты в примерах условные.

## С чего начать

| Задача                                  | Раздел                                                                                                             |
| --------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| Запустить API локально                  | [Быстрый старт](/govor-api/getting-started.md)                                                                     |
| Подключить собственный клиент           | [Путь интеграции](/govor-api/getting-started/client-integration.md), [карта HTTP API](/govor-api/api-reference.md) |
| Разобраться с входом и токенами         | [Аутентификация](/govor-api/authentication.md)                                                                     |
| Восстановить историю или сменить пароль | [Пароли и восстановление](/govor-api/authentication/password-recovery.md)                                          |
| Понять шифрование                       | [E2EE](/govor-api/e2ee.md), [API устройств и архивов](/govor-api/e2ee/e2ee-api.md)                                 |
| Настроить сервер на Timeweb             | [VPS](/govor-api/deployment/vps-deployment.md) или [App Platform](/govor-api/deployment/timeweb-deployment.md)     |
| Найти причину ошибки                    | [Диагностика](/govor-api/deployment/diagnostics.md), [частые вопросы](/govor-api/getting-started/faq.md)           |
| Проверить изменения                     | [Тестирование](/govor-api/deployment/testing.md)                                                                   |

## Возможности

* Регистрация по приглашению, вход с доказательством пароля SRP, access/refresh токены и управление сессиями.
* Друзья, заявки, личные чаты, группы и каналы с отдельными ролями, приглашениями и модерацией.
* История, отправка и редактирование сообщений, прочтение, удаление, реакции и паки.
* E2EE сообщений и вложений, сертификаты устройств, ротация ключей, зашифрованный архив и восстановление по паролю/коду.
* Профили, аватары, присутствие, SignalR-события и очередь push через Firebase.
* PostgreSQL, миграции, Docker и GitHub Actions для развёртывания.

## Что важно знать до интеграции

`userId` — пользователь, `sessionId` — сеанс входа, `chatId` — чат. Для личного сообщения `recipientId` означает **PrivateChat.Id**, а не ID собеседника. `recipientType`: `0` — личный чат, `1` — группа/канал.

HTTP загружает состояние, SignalR передаёт команды и события. После переподключения клиент перечитывает состояние через HTTP. События могут повторяться или пропускаться; push не подтверждает прочтение.

E2EE реализовано прикладным протоколом JOSE. Он не предоставляет forward secrecy, post-compromise security и прозрачность ключей; первая встреча и состав групп доверяют серверу. [Модель доверия](/govor-api/e2ee.md) обязательна к прочтению перед реализацией другого клиента.

В проверке этой ревизии прошли 735 серверных тестов на SQLite. Это не подтверждение доставки Firebase на устройство или состояния production-инсталляции. [Ограничения проверки](/govor-api/deployment/testing.md).

Исходный код: [Govor, a3401ce](https://github.com/stalcker2288969/Govor/tree/a3401ceedf30c2eb6167f7ef6e4ae820883d2de2).
