Files
Govor/docs/endpoints/admin-and-groups.md
T
Artemy 2e9d7e625e Add primitive groups and required channel
Adds server-side group and channel management, private invitations, member moderation, avatar handling, and required-channel configuration. This change also introduces SignalR group profile/member notifications, updates registration to atomically join required channels, and adds EF migration and test coverage for group membership, permissions, and invitation expiry rules.
2026-10-04 10:35:07 +07:00

21 lines
2.3 KiB
Markdown

# Администрирование сервера
Серверные административные маршруты требуют роль Admin и активную access-сессию. Администратор сервера и админ группы — разные права: роль в группе не открывает маршруты `/api/admin`.
| Метод | Маршрут | Назначение |
| --- | --- | --- |
| POST | `/api/admin/InviteUser/Invitation` | Приглашение регистрации: endDate, maxParticipants, isAdmin, description |
| GET | `/api/admin/InviteUser` | Список приглашений |
| GET | `/api/admin/InviteUser/GetAllActiveInvitations` | Активные приглашения |
| GET | `/api/admin/InviteUser/{id}` | Приглашение по ID |
| GET | `/api/admin/Users/all` | До 50 пользователей |
| GET | `/api/admin/Users/{id}` | Пользователь по ID |
| POST | `/api/admin/Users/user/{id}/password` | `{ "password": "..." }`; 204, отзыв сессий и push-токенов |
| GET / PUT | `/api/admin/required-channel` | Канал для всех новых пользователей, право выхода |
UserResponse не содержит passwordHash. Старый GET смены пароля с паролем в URL удалён. JWT роль Admin формируется по Invitation.IsAdmin пользователя. Настройки обязательного канала и изменения паков реакций дополнительно проверяют это право в БД.
Паки: [административный API реакций](reactions.md). Обязательный канал, владелец/админы, приглашения и модерация: [группы и каналы](groups.md).
Создание административных приглашений выдаёт возможность зарегистрировать серверного администратора, поэтому этот API предназначен только для доверенных администраторов сервера. Административный FriendshipsController и пустой GroupsHub остаются неиспользуемыми заготовками.