GET Hero Position Filters
/web/mlbb/heroes/positions
Filter heroes by their position on the map using role and lane criteria. Supports multiple query parameters for roles and lanes, along with pagination, sorting, and localization.
Query parameters:
- role: Role filter (multi allowed). Values:
tank,fighter,assassin,mage,marksman,support.
Example: role=tank&role=fighter
- lane: Lane filter (multi allowed). Values:
exp,mid,roam,jungle,gold.
Example: lane=exp&lane=mid
- 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 hero position data:
- records: Array of hero entries, each containing:
- data:
- hero:
- data:
- name: Hero name.
- smallmap: Hero smallmap image URL.
- roadsort: Array of lane metadata objects:
- _id: Unique identifier.
- caption: Lane caption (localized).
- configId: Configuration ID.
- createdAt: Creation timestamp.
- createdUser: Creator username.
- data:
- _object: Object reference ID.
- road_sort_icon: Lane icon URL.
- road_sort_id: Lane ID.
- road_sort_title: Lane title (e.g., Roam).
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- sortid: Array of role metadata objects:
- _id: Unique identifier.
- caption: Role caption (localized).
- configId: Configuration ID.
- createdAt: Creation timestamp.
- createdUser: Creator username.
- data:
- _object: Object reference ID.
- sort_icon: Role icon URL.
- sort_id: Role ID.
- sort_title: Role title (e.g., Support).
- updatedAt: Last update timestamp.
- updatedUser: Last updater username.
- data:
- hero_id: Unique hero identifier.
- relation:
- assist:
- target_hero_id: Array of hero IDs assisted.
- strong:
- target_hero_id: Array of hero IDs this hero is strong against.
- weak:
- target_hero_id: Array of hero IDs this hero is weak against.
- assist:
- hero:
- id: Record identifier.
- data:
This endpoint is useful for:
- Building filtered hero lists.
- Analyzing hero roles and lane assignments.
- Understanding hero relationships (assist, strong, weak).
{
"code": 0,
"message": "OK",
"data": {
"records": [
{
"data": {
"hero": {
"data": {
"name": "Marcel",
"roadsort": [
{
"_id": "66854202aa8e7f6ec4703d8f",
"caption": "\u8f85\u52a9",
"configId": 144237,
"createdAt": 1720009218480,
"createdUser": "nickjin",
"data": {
"_object": 2732073,
"road_sort_icon": "https://akmweb.youngjoygame.com/web/gms/image/a3dbb075b4d8186c29f02f7d47da236a.svg",
"road_sort_id": "3",
"road_sort_title": "Roam"
},
"id": 2732083,
"linkId": [
2732073
],
"sort": 0,
"updatedAt": 1723022949109,
"updatedUser": "nickjin"
},
""
],
"smallmap": "https://akmweb.youngjoygame.com/web/svnres/img/mlbb/homepage_2_1_42/100_82e5c2646276cd907f69cc800057c737.png",
"sortid": [
{
"_id": "6698c06a613093b976b4a97c",
"caption": "6\u8f85\u52a9",
"configId": 144237,
"createdAt": 1721286762785,
"createdUser": "nickjin",
"data": {
"_object": 2740651,
"sort_icon": "https://akmweb.youngjoygame.com/web/gms/image/1e4609b25a4cd63ee5a13015d4058159.png",
"sort_id": "6",
"sort_title": "support"
},
"id": 2740666,
"linkId": [
2740651
],
"sort": 0,
"updatedAt": 1723023113317,
"updatedUser": "nickjin"
},
""
]
}
},
"hero_id": 132,
"relation": {
"assist": {
"target_hero_id": [
60,
121
]
},
"strong": {
"target_hero_id": [
18,
38
]
},
"weak": {
"target_hero_id": [
84,
83
]
}
}
},
"id": 3280483
}
],
"total": 132
}
}