🔐 API Авторизация
API Svortex использует JWT (JSON Web Tokens) для авторизации запросов. Это обеспечивает безопасность и простоту использования.
🌐 Base URL
https://svortex.ru/apiВсе API эндпоинты начинаются с этого базового URL.
📝 Регистрация
POST /auth/register
PublicОтправить код подтверждения на email:
{
"username": "john_doe",
"email": "john@gmail.com",
"password": "securepass123",
"referral_code": "ABC123" // опционально
}{
"message": "Код подтверждения отправлен на ваш email",
"email": "john@gmail.com",
"expiresIn": 15
}POST /auth/complete-registration
PublicЗавершить регистрацию с кодом:
{
"username": "john_doe",
"email": "john@gmail.com",
"password": "securepass123",
"code": "123456",
"referral_code": "ABC123" // опционально
}{
"message": "Регистрация успешна",
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": {
"id": 123,
"username": "john_doe",
"email": "john@gmail.com",
"balance": 0,
"is_admin": false
}
}🔑 Вход
POST /auth/login
Public{
"email": "john@gmail.com",
"password": "securepass123"
}{
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
"user": {
"id": 123,
"username": "john_doe",
"email": "john@gmail.com",
"balance": 150.50,
"is_admin": false,
"pterodactyl_id": 456
}
}⚠️ Rate Limiting: Максимум 5 попыток входа за 15 минут.
🎫 Использование токена
После успешной авторизации используйте полученный JWT токен в заголовке Authorization:
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...curl -X GET https://svortex.ru/api/user/profile \
-H "Authorization: Bearer YOUR_JWT_TOKEN" \
-H "Content-Type: application/json"const response = await fetch('https://svortex.ru/api/user/profile', {
method: 'GET',
headers: {
'Authorization': `Bearer ${token}`,
'Content-Type': 'application/json'
}
});
const data = await response.json();👤 Информация о пользователе
GET /user/profile
Auth RequiredПолучить информацию о текущем пользователе:
{
"id": 123,
"username": "john_doe",
"email": "john@gmail.com",
"first_name": "John",
"last_name": "Doe",
"balance": 150.50,
"is_admin": false,
"pterodactyl_id": 456,
"referral_code": "ABC123",
"created_at": "2025-01-01T00:00:00.000Z"
}❌ Коды ошибок
Неверные данные в запросе. Проверьте поля и формат.
Токен отсутствует, невалиден или истек.
Недостаточно прав для выполнения операции.
Запрошенный ресурс не найден.
Превышен лимит запросов. Подождите и повторите.
Внутренняя ошибка сервера. Обратитесь в поддержку.
⏱️ Rate Limiting
API защищен от злоупотреблений системой rate limiting:
ℹ️ При превышении лимита вы получите ответ 429 Too Many Requests с заголовком Retry-After указывающим когда можно повторить запрос.