MLBB API Web v4.0.8
MLBB Card Install OpenMLBB Tutorial GitHub Stars
Home User MLBB Academy Addon

Web Playground

Academy Endpoint

Interactive request form for this API endpoint.

Each card below maps directly to an API endpoint. Query, path, and request body fields are generated from OpenAPI.

Jump to endpoint

GET /web/academy/meta/version GET /web/academy/heroes/catalog GET /web/academy/roles GET /web/academy/equipment GET /web/academy/equipment/expanded GET /web/academy/spells GET /web/academy/emblems GET /web/academy/ranks GET /web/academy/ranks/{rank_id} GET /web/academy/recommended GET /web/academy/recommended/{recommended_id} GET /web/academy/heroes GET /web/academy/heroes/{hero_identifier}/stats GET /web/academy/heroes/{hero_identifier}/lane GET /web/academy/heroes/{hero_identifier}/win-rate/timeline GET /web/academy/heroes/{hero_identifier}/builds GET /web/academy/heroes/{hero_identifier}/counters GET /web/academy/heroes/{hero_identifier}/teammates GET /web/academy/heroes/{hero_identifier}/trends GET /web/academy/heroes/{hero_identifier}/recommended GET /web/academy/heroes/ratings GET /web/academy/heroes/ratings/{subject}

GET Roles

/web/academy/roles

Open Only This

List all hero roles available in the game (Tank, Fighter, Assassin, Mage, Marksman, Support). Supports query parameters for pagination, sorting, and localization.

Query parameters:

  • size: Number of items per page (minimum: 1).
  • index: Page index (starting from 1).
  • order: Sort order for results. Allowed values: asc, desc.
  • lang: Language code for localized content (default: en).

The response includes role data:

  • records: Array of role entries, each containing:
      • _id: Unique record identifier.
      • caption: Localized role caption (e.g., '坦克', '法师').
      • configId: Configuration ID.
      • createdAt: Creation timestamp.
      • createdUser: Creator username.
      • updatedAt: Last update timestamp.
      • updatedUser: Last updater username.
      • data:
          • emblem_id: Emblem ID associated with the role.
          • emblem_title: Emblem title (e.g., 'Tank', 'Mage').
          • emblem_icon: Emblem icon URL.
          • emblem_detail:
              • _id: Emblem detail record ID.
              • _createdAt: Creation timestamp.
              • _updatedAt: Last update timestamp.
              • data:
                  • emblemid: Emblem ID.
                  • emblemname: Emblem name (e.g., 'Assassin').
                  • emblemattrid: Attribute ID.
                  • emblemattr: Attribute bonuses (e.g., '+500 Extra Max HP').
                  • attriicon: Attribute icon URL.
                  • attriicon2: Secondary attribute icon URL (optional).
                  • emblembg: Background indicator.

This endpoint is useful for:

  • Displaying role categories.
  • Explaining role-specific attributes and emblem bonuses.
  • Guiding players in hero selection based on roles.
size query

Number of items per page. Minimum: 1.

index query

Page index for pagination. Minimum: 1.

order query
▾

Sort order by emblem_id.

lang query
▾

Language code for localized content.

GET /api/academy/roles