GET Deprecated Auth User Friends
/web/user/friends
⚠
This endpoint is deprecated and may be removed or changed in a future version. Avoid using it in new integrations.
Retrieve the authenticated player's friends information using a valid JWT. Supports query parameters for season filtering and localization. Requires an Authorization header with the JWT from login.
Headers:
- Authorization:
Bearer <jwt>(JWT obtained during login).
Query parameters:
- sid: Season ID for filtering friends (must be a valid season ID from
/api/user/season). - lang: Language code for localized content (default:
en).
The response includes friend statistics and metadata:
- bfs: Best Friends (highlighted or prioritized friends list, may be null).
- wfs: Weekly Friends (friends interacted with recently, may be empty).
- fs: Friends list entries, each containing:
- f: Friend object with identifiers:
- rid: Role ID (unique player identifier).
- zid: Zone ID (server region).
- n: Name (may be empty if private).
- ax: Avatar URL (may be empty).
- pri: Privacy flag (true if details are hidden).
- frid: Friend Role ID (unique identifier for the friend).
- fzid: Friend Zone ID (server region for the friend).
- cl: Current Level of the friend.
- l: Level (same as cl, sometimes duplicated).
- tbc: Total Battle Count (matches played together).
- twc: Total Win Count (matches won together).
- f: Friend object with identifiers:
This endpoint is useful for:
- Displaying a player's friend list.
- Tracking shared match history.
- Analyzing cooperative performance with friends across different seasons.
{
"code": 0,
"message": "Success",
"traceID": "e0516a11c845c6ca93a1a43178c2f510",
"data": {
"wfs": [],
"fs": [
{
"f": {
"rid": 0,
"zid": 0,
"n": "",
"ax": "",
"pri": true
},
"frid": 0,
"fzid": 0,
"cl": 42,
"l": 42,
"tbc": 7,
"twc": 6
}
]
}
}