Архитектура
Bedolaga предоставляет единый FastAPI-сервер на порту8080 с тремя областями API:
710
Эндпоинтов
898
Pydantic-схем
85
Групп (тегов)
По областям
Авторизация
Web API — API Key
Все эндпоинты Web API требуют ключ в заголовке:POST /tokens.
Cabinet API — JWT
Cabinet использует JWT-токены (HS256):
Обновление:
POST /cabinet/auth/refresh с refresh-токеном.
Cabinet Admin API
Те же JWT-токены, но пользователь должен быть администратором (ADMIN_IDS / ADMIN_EMAILS) или иметь назначенную роль RBAC с нужными разрешениями.
Быстрый старт
1
Health Check
{"status": "ok"}2
Получить список пользователей
3
Создать подписку
WebSocket
Два WebSocket-эндпоинта для real-time обновлений:По вебсокету кабинета приходят и события рекуррентных СБП-подписок Platega (
sbp_recurring.*), и события тикетов (ticket.created, ticket.status_changed, message.created).Web API — группы
Пользователи и подписки
Пользователи и подписки
Ручное пополнение (
v3.67.0): POST /users/{id}/deposit начисляет сумму на баланс и проводит её через весь пост-топап конвейер — уведомления, автопокупку из корзины, реферальные бонусы. Операция идемпотентна по внешнему ключу, повтор с тем же ключом деньги не удваивает.Потолок одной операции задаётся WEB_API_MANUAL_DEPOSIT_MAX_KOPEKS (по умолчанию 10 000 ₽, 0 — без ограничения). Эндпоинт рассчитан на автоматизацию — например, на AI-агента поддержки, — и лимит служит предохранителем от ошибки на два порядка.Контент и рассылки
Контент и рассылки
Маркетинг
Маркетинг
Инфраструктура
Инфраструктура
Интеграции
Интеграции
Cabinet API — группы
Пользовательский кабинет (146 эндпоинтов)
Пользовательский кабинет (146 эндпоинтов)
Админ-панель (287 эндпоинтов)
Админ-панель (287 эндпоинтов)
Документация на сервере
При включённомIS_DOCS_ENABLED=true доступны:
- Swagger UI:
https://your-domain.com/docs - ReDoc:
https://your-domain.com/redoc - OpenAPI JSON:
https://your-domain.com/openapi.json