AI PadelAPI documentation Back to site

AISOLUS rating

The 1.0–7.0 scale, player rating and top players.

Base URL: https://your-server/api · Guide for this section: Leads and rating

Rating scale #

GET/v1/rating/scale

Access: Public No authorization.

The AISOLUS rating scale from 1.0 to 7.0: nine steps with names and descriptions, and the rules. Public method.

Example request

curl -X GET "https://your-server/api/v1/rating/scale"

Responses

CodedetailMeaning
200—Success; example below

Example response

{
  "low": 1.0,
  "high": 7.0,
  "steps": [{"from": 1.0, "to": 1.49, "name": "<step name>", "text": "<step text>"}],
  "rules": ["<rule text>"]
}

My rating #

GET/v1/rating/me

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

The player's rating: value, step, reliability, status, camera assessment on three criteria and the change history (up to 40 events).

Headers

NameTypeRequiredDescription
AuthorizationstringyesBearer <player token>

Example request

curl -X GET "https://your-server/api/v1/rating/me" \
  -H "Authorization: Bearer <player token>"

Responses

CodedetailMeaning
200—Success
401no_tokenNo token in the Authorization header
401invalid_tokenToken expired or invalid — refresh it via /v1/auth/refresh

Another player's rating #

GET/v1/rating/user/{uid}

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

Another player's value, step, games and reliability — without history or camera assessment.

Path parameters

NameTypeRequiredDescription
uidstring (uuid)yesPlayer id

Headers

NameTypeRequiredDescription
AuthorizationstringyesBearer <player token>

Example request

curl -X GET "https://your-server/api/v1/rating/user/a52e7c14-90bd-4e3f-8c61-7d2f0b9e4a15" \
  -H "Authorization: Bearer <player token>"

Responses

CodedetailMeaning
200—Success
401no_tokenNo token in the Authorization header
401invalid_tokenToken expired or invalid — refresh it via /v1/auth/refresh
404user_not_foundUser not found
422[…]Parameter or body validation error: detail is a list of errors

Top players by AISOLUS rating #

GET/v1/rating/leaderboard

Access: Player token Header Authorization: Bearer <player token> — issued by SMS sign-in.

Rated players in descending order: everywhere or only those with counted matches in club club_id. limit is 1 to 200 (50 by default). The me field marks the current player.

Query parameters

NameTypeRequiredDescription
club_idstringnoClub id
limitintegernoHow many rows to return
default 50

Headers

NameTypeRequiredDescription
AuthorizationstringyesBearer <player token>

Example request

curl -X GET "https://your-server/api/v1/rating/leaderboard?club_id=c1&limit=200" \
  -H "Authorization: Bearer <player token>"

Responses

CodedetailMeaning
200—Success; example below
401no_tokenNo token in the Authorization header
401invalid_tokenToken expired or invalid — refresh it via /v1/auth/refresh
422[…]Parameter or body validation error: detail is a list of errors

Example response

{
  "items": [
    {
      "place": 1,
      "userId": "3d6e9a10-5b2c-4f8e-a1d7-6c4b2e0f9a83",
      "name": "Ivan P.",
      "value": 4.85,
      "step": "<step name>",
      "games": 41,
      "me": false
    }
  ]
}