GET Ranks List
/openmlbb/academy/ranks
API Path: /api/academy/ranks
Retrieve all rank information for MLBB. Supports query parameters for pagination and localization.
Query parameters:
- size: Number of items per page (minimum: 1).
- index: Page index (starting from 1).
- lang: Language code for localized content (default:
en).
The response includes rank data:
- records: Array of rank entries, each containing:
- _id: Unique record identifier.
- configId: Configuration ID.
- caption: Localized caption (e.g., '1-4勇士Ⅲ').
- createdAt: Creation timestamp.
- createdUser: Creator username.
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- data:
- bigrank: Major rank ID (e.g., 1).
- bigrank_name: Major rank name (e.g., '勇士').
- icon: Rank icon URL.
- minrank: Minor rank ID (e.g., '1').
- minrank_name: Minor rank name (e.g., 'Ⅲ').
- rankid_start: Starting rank ID in the range.
- rankid_end: Ending rank ID in the range.
- id: Internal record ID.
- sort: Sorting index.
This endpoint is useful for:
- Displaying the full rank progression system.
- Explaining rank tiers and ranges.
- Guiding players in understanding MLBB's ranking structure.
Python Example
from OpenMLBB import OpenMLBB
client = OpenMLBB()
response = client.academy.ranks(size=20, index=1, lang="en")
print(response)Path and Query Parameters
| Name | In | Type | Required | Default |
|---|---|---|---|---|
| size | query | integer | no | 20 |
| index | query | integer | no | 1 |
| lang | query | string | no | en |