赛事列表 - 火星数据

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

请求参数

Query 参数

sport_id

string

可选

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

league_id

integer

搜索联赛下的赛事

可选

page

integer

页数

可选

per_page

integer

可选

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

status

string

可选

赛事状态，upcoming(未开始)，live(进行中)，past(已结束)， cancel(已取消)，delete（已删除）

示例值:

live

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

必需

total

integer

总条数

必需

msg

string

接口响应信息

必需

示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "sport_id": 1,
        "series_id": 35094,
        "region_id": 200,
        "league_id": 1821,
        "name": "LPL-夏季赛 2024",
        "name_en": "LPL-Summer 2024",
        "abbr": "LPL-夏季赛",
        "abbr_en": "LPL",
        "logo": "/league/3f0930a599dce336646000f18f87e236.png",
        "status": "past",
        "start_time": 1720170000,
        "end_time": 1722430800,
        "intro": "",
        "location": "上海 苏州 北京 西安",
        "location_en": "shanghai xian beijing shuzhou",
        "host": "Tencent Games",
        "game_version": "",
        "level": 2,
        "cover": "/league/1bb9aa4c9b44246e263c74202ec786bd.png",
        "bonus": "$579,690",
        "ordinary_mvp": 765,
        "finals_mvp": 765,
        "menu": [
          0,
          1,
          0,
          1
        ],
        "update_time": 1725004803
      },
      {
        "sport_id": 1,
        "series_id": 32463,
        "region_id": 200,
        "league_id": 1945,
        "name": "德玛西亚杯-2023",
        "name_en": "Demacia Cup-2023",
        "abbr": "德玛西亚杯",
        "abbr_en": "Demacia Cup 2023",
        "logo": "/league/8967dee72fe3272cdbb816e063ac192c.png",
        "status": "past",
        "start_time": 1720044000,
        "end_time": 1720386000,
        "intro": "",
        "location": "中国",
        "location_en": "China",
        "host": "Tencent Games",
        "game_version": "",
        "level": 1,
        "cover": "/league/4ec256c9082c1208ca3f0995df1bc8c9.png",
        "bonus": "",
        "ordinary_mvp": 40927,
        "finals_mvp": 30470,
        "menu": [
          0,
          1,
          0,
          1
        ],
        "update_time": 1721460061
      }
    ],
    "total": 2
  },
  "msg": "success"
}