Рейтинг AISOLUS
Шкала 1,0–7,0, рейтинг игрока и таблица лучших.
Шкала рейтинга #
/v1/rating/scaleДоступ: Публичный Без авторизации.
Шкала рейтинга AISOLUS от 1,0 до 7,0: девять ступеней с названиями и описаниями и правила. Публичный метод.
Пример запроса
curl -X GET "https://адрес-вашего-сервера/api/v1/rating/scale"Ответы
| Код | detail | Значение |
|---|---|---|
| 200 | — | Успешный ответ; пример ниже |
Пример ответа
{
"low": 1.0,
"high": 7.0,
"steps": [
{
"from": 1.0,
"to": 1.49,
"name": "Первые шаги",
"text": "Осваиваются правила и хват…"
}
],
"rules": ["Число двигают результаты игр: сила соперников и разница в счёте."]
}Мой рейтинг #
/v1/rating/meДоступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.
Рейтинг игрока: значение, ступень, надёжность, статус, оценка камер по трём критериям и история изменений (до 40 событий).
Заголовки
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
Authorization | строка | да | Bearer <токен игрока> |
Пример запроса
curl -X GET "https://адрес-вашего-сервера/api/v1/rating/me" \
-H "Authorization: Bearer <токен игрока>"Ответы
| Код | detail | Значение |
|---|---|---|
| 200 | — | Успешный ответ |
| 401 | no_token | Нет токена в заголовке Authorization |
| 401 | invalid_token | Токен просрочен или подделан — обновите его через /v1/auth/refresh |
Рейтинг другого игрока #
/v1/rating/user/{uid}Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.
Значение, ступень, число игр и надёжность другого игрока — без истории и оценки камер.
Параметры пути
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
uid | строка (uuid) | да | Идентификатор игрока |
Заголовки
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
Authorization | строка | да | Bearer <токен игрока> |
Пример запроса
curl -X GET "https://адрес-вашего-сервера/api/v1/rating/user/a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15" \
-H "Authorization: Bearer <токен игрока>"Ответы
| Код | detail | Значение |
|---|---|---|
| 200 | — | Успешный ответ |
| 401 | no_token | Нет токена в заголовке Authorization |
| 401 | invalid_token | Токен просрочен или подделан — обновите его через /v1/auth/refresh |
| 404 | user_not_found | Пользователь не найден |
| 422 | […] | Ошибка проверки параметров или тела: detail — список ошибок |
Лучшие по рейтингу AISOLUS #
/v1/rating/leaderboardДоступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.
Игроки с рейтингом по убыванию: везде или только сыгравшие засчитанные матчи в клубе club_id. limit — от 1 до 200 (по умолчанию 50). Поле me отмечает текущего игрока.
Параметры запроса
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
club_id | строка | нет | Идентификатор клуба |
limit | целое | нет | Сколько записей вернуть по умолчанию 50 |
Заголовки
| Имя | Тип | Обязательно | Описание |
|---|---|---|---|
Authorization | строка | да | Bearer <токен игрока> |
Пример запроса
curl -X GET "https://адрес-вашего-сервера/api/v1/rating/leaderboard?club_id=c1&limit=200" \
-H "Authorization: Bearer <токен игрока>"Ответы
| Код | detail | Значение |
|---|---|---|
| 200 | — | Успешный ответ; пример ниже |
| 401 | no_token | Нет токена в заголовке Authorization |
| 401 | invalid_token | Токен просрочен или подделан — обновите его через /v1/auth/refresh |
| 422 | […] | Ошибка проверки параметров или тела: detail — список ошибок |
Пример ответа
{
"items": [
{
"place": 1,
"userId": "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83",
"name": "Иван П.",
"value": 4.85,
"step": "Полупрофессионал",
"games": 41,
"me": false
}
]
}