选手列表

接口概述：
获取游戏中的选手数据，根据自定义参数查询。
该接口返回所请求参数下的所有选手。

推荐请求
初始化：首次全量更新，根据游戏ID获取选手全量数据
更新数据：后续增量更新，根据参数recent_update获取增量变动数据
建议频率：1min/次

Request

Query Params

sport_id

string

optional

游戏ID，支持传多个ID，ID间用英文逗号隔开

team_id

integer

optional

筛选某个队伍下的所有选手数据

status

string

optional

选手状态，work 现役，retired 退役， delete(已删除)

page

integer

optional

页数

per_page

integer

optional

每页数据条数，不传时默认返回20条数据

language

string

optional

多语言名称,详细参数看API指南（全局多语言），不传该参数默认返回英文

recent_update

string

optional

更新时间：筛选最近时间段更新的数据，支持30m,1h,12h,48h

Responses

🟢200成功

application/json

Body

code

integer

错误码

required

0-请求成功

data

object

required

list

array [object {17}]

required

total

integer

总条数

required

msg

string

接口信息

required

Example

{
    "code": 0,
    "data": {
        "list": [
            {
                "sport_id": 1,
                "player_id": 139451,
                "team_id": 31094,
                "league_id": 0,
                "region_id": 200,
                "sportsman_id": 0,
                "name": "徐士傑",
                "name_en": "TPElXU",
                "abbr": "tpelxu",
                "abbr_en": "tpelxu",
                "logo": "/lol/player/f797c33b1a2e8af61bbde3fe6018e5ca.jpg",
                "position": "top",
                "status": "work",
                "half_logo": "/default/default.png",
                "is_first": 0,
                "power_value": 0,
                "update_time": 1695802926
            },
            {
                "sport_id": 1,
                "player_id": 139450,
                "team_id": 24517,
                "league_id": 0,
                "region_id": 200,
                "sportsman_id": 0,
                "name": "林伟伦",
                "name_en": "Mass",
                "abbr": "masllimlwl",
                "abbr_en": "masllimlwl",
                "logo": "/lol/player/88e9d07a3b54b2e32a3210ce274fa019.jpg",
                "position": "mid",
                "status": "work",
                "half_logo": "/default/default.png",
                "is_first": 0,
                "power_value": 0,
                "update_time": 1695809140
            }
        ],
        "total": 2
    },
    "msg": "success"
}

Request

Request samples

Responses