Object Server

Object Server — основной сервер данных Saschat. Управляет серверами, каналами, сообщениями, ролями, голосовыми каналами, медиафайлами и ботами.

Базовый URL: http://your-server:8082

Аутентификация

Большинство запросов требуют JWT-токен в заголовке:

Authorization: Bearer <access_token>

Токен выдаётся Auth Server'ом и верифицируется через JWKS. Object Server кэширует публичные ключи и обновляет их каждые 5 минут.

Из токена извлекаются:

Все ошибки возвращаются в едином формате:

{
  "error": "NOT_FOUND",
  "message": "Server not found",
  "details": null
}

Поле	Тип	Описание
`error`	string	Код ошибки
`message`	string	Человекочитаемое сообщение
`details`	string[]?	Детали (для ошибок валидации)

Код	HTTP	Описание
`UNAUTHORIZED`	401	Отсутствует или невалидный токен
`FORBIDDEN`	403	Недостаточно прав
`NOT_FOUND`	404	Ресурс не найден
`ALREADY_EXISTS`	409	Ресурс уже существует
`VALIDATION_ERROR`	400	Ошибка валидации входных данных
`INVITE_EXPIRED`	410	Инвайт просрочен
`INVITE_EXHAUSTED`	410	Исчерпан лимит использований инвайта
`FILE_TOO_LARGE`	413	Файл превышает максимальный размер
`CHANNEL_FULL`	403	Канал достиг лимита участников
`MESSAGE_TOO_LONG`	400	Сообщение превышает максимальную длину
`INTERNAL_ERROR`	500	Внутренняя ошибка сервера

Для операций без возвращаемого объекта:

{
  "message": "Server deleted"
}