选手列表 - 火星数据

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

请求参数

Query 参数

sport_id

string

可选

运动ID，支持传多个ID，ID间用英文逗号隔开

team_id

string

可选

队伍ID,筛选该队伍下的选手，支持传多个ID，ID间用英文逗号隔开

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 {15}]

必需

total

integer

数据总条数

必需

msg

string

接口响应信息

必需

示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "sport_id": 202,
        "player_id": 1059619,
        "name": "斯特凡诺·曼吉亚波科",
        "name_en": "stefano mangiapoco",
        "abbr": "斯特凡诺",
        "abbr_en": "stefano ",
        "status": "work",
        "league_id": 134,
        "team_id": 3942,
        "logo": "/default/default.png",
        "half_logo": "/default/default.png",
        "position": "G",
        "number": 22,
        "country_id": 1,
        "update_time": 1726867221
      },
      {
        "sport_id": 202,
        "player_id": 1059618,
        "name": "杰西卡·马佐",
        "name_en": "Jessica Mazo",
        "abbr": "杰西卡",
        "abbr_en": "Jessica",
        "status": "work",
        "league_id": 2354,
        "team_id": 1981,
        "logo": "/default/default.png",
        "half_logo": "/default/default.png",
        "position": "M",
        "number": 6,
        "country_id": 5,
        "update_time": 1726865077
      }
    ],
    "total": 2
  },
  "msg": "success"
}