AISOLUS rating
The 1.0–7.0 scale, player rating and top players.
Rating scale #
/v1/rating/scaleAccess: 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
| Code | detail | Meaning |
|---|---|---|
| 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 #
/v1/rating/meAccess: 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
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | yes | Bearer <player token> |
Example request
curl -X GET "https://your-server/api/v1/rating/me" \
-H "Authorization: Bearer <player token>"Responses
| Code | detail | Meaning |
|---|---|---|
| 200 | — | Success |
| 401 | no_token | No token in the Authorization header |
| 401 | invalid_token | Token expired or invalid — refresh it via /v1/auth/refresh |
Another player's rating #
/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
| Name | Type | Required | Description |
|---|---|---|---|
uid | string (uuid) | yes | Player id |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | yes | Bearer <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
| Code | detail | Meaning |
|---|---|---|
| 200 | — | Success |
| 401 | no_token | No token in the Authorization header |
| 401 | invalid_token | Token expired or invalid — refresh it via /v1/auth/refresh |
| 404 | user_not_found | User not found |
| 422 | […] | Parameter or body validation error: detail is a list of errors |
Top players by AISOLUS rating #
/v1/rating/leaderboardAccess: 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
| Name | Type | Required | Description |
|---|---|---|---|
club_id | string | no | Club id |
limit | integer | no | How many rows to return default 50 |
Headers
| Name | Type | Required | Description |
|---|---|---|---|
Authorization | string | yes | Bearer <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
| Code | detail | Meaning |
|---|---|---|
| 200 | — | Success; example below |
| 401 | no_token | No token in the Authorization header |
| 401 | invalid_token | Token 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
}
]
}