选手列表 - 火星数据

接口概述：
1.首次全量更新，根据游戏ID获取选手全量数据
2.后续增量更新，根据参数recent_update获取增量变动数据
建议频率：1min/次

请求参数

Query 参数

sport_id

string

可选

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

team_id

integer

可选

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

status

string

可选

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

page

integer

页数

可选

per_page

integer

可选

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

language

string

可选

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

recent_update

string

可选

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

Header 参数

app_id

string

用户ID

必需

默认值:

marz2025

app_secret

string

用户秘钥

必需

默认值:

d9b8eafc3b5a48b7a5f1c6d2e4f8a9e5b3d7c2a1f4e6b8a9d5f1c7e2b9d3a6f4

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

code

integer

错误码

必需

0-请求成功

data

object

必需

list

array [object {17}]

必需

total

integer

总条数

必需

msg

string

接口信息

必需

示例

{
  "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"
}