AI ПаделДокументация API На сайт

Рейтинг AISOLUS

Шкала 1,0–7,0, рейтинг игрока и таблица лучших.

Базовый адрес: https://адрес-вашего-сервера/api · Руководство по разделу: Заявки и рейтинг

Шкала рейтинга #

GET/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": ["Число двигают результаты игр: сила соперников и разница в счёте."]
}

Мой рейтинг #

GET/v1/rating/me

Доступ: Токен игрока Заголовок Authorization: Bearer <токен игрока> — токен по SMS-входу.

Рейтинг игрока: значение, ступень, надёжность, статус, оценка камер по трём критериям и история изменений (до 40 событий).

Заголовки

ИмяТипОбязательноОписание
AuthorizationстрокадаBearer <токен игрока>

Пример запроса

curl -X GET "https://адрес-вашего-сервера/api/v1/rating/me" \
  -H "Authorization: Bearer <токен игрока>"

Ответы

КодdetailЗначение
200—Успешный ответ
401no_tokenНет токена в заголовке Authorization
401invalid_tokenТокен просрочен или подделан — обновите его через /v1/auth/refresh

Рейтинг другого игрока #

GET/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—Успешный ответ
401no_tokenНет токена в заголовке Authorization
401invalid_tokenТокен просрочен или подделан — обновите его через /v1/auth/refresh
404user_not_foundПользователь не найден
422[…]Ошибка проверки параметров или тела: detail — список ошибок

Лучшие по рейтингу AISOLUS #

GET/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—Успешный ответ; пример ниже
401no_tokenНет токена в заголовке Authorization
401invalid_tokenТокен просрочен или подделан — обновите его через /v1/auth/refresh
422[…]Ошибка проверки параметров или тела: detail — список ошибок

Пример ответа

{
  "items": [
    {
      "place": 1,
      "userId": "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83",
      "name": "Иван П.",
      "value": 4.85,
      "step": "Полупрофессионал",
      "games": 41,
      "me": false
    }
  ]
}