比赛列表接口 - 火星数据

接口概述：
获取游戏比赛赛程数据-自定义参数查询
该接口返回所请求参数的全量赛程数据（请求限制：前后30天的赛程）

推荐请求
初始化数据：根据日期请求，跑一遍前后30天的赛程
更新数据：
方案1：请求10分钟内有变化的赛程数据：1次/min（全量更新）
方案2：接入推送，实时接收有变化的数据（长链接推送/实时数据推送/比赛推送）
频率限制：30次/min

请求参数

Query 参数

sport_id

string

可选

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

示例值:

match_id

string

可选

比赛ID，支持传多个ID，ID间用英文逗号隔开

league_id

string

可选

联赛ID，支持传多个ID，ID间用英文逗号隔开

series_id

string

可选

赛事ID，支持传多个ID，ID间用英文逗号隔开

status

string

可选

未开始-upcoming，进行中-live，已结束-past，已取消-cancel，延迟-delayed，已删除-detele

start_time_from

integer

开始时间

可选

start_time_to

integer

结束时间

可选

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": 1,
        "match_id": 363435,
        "league": {
          "league_id": 1894,
          "region_id": 202,
          "name": "精英联赛",
          "name_en": "elite league",
          "abbr": "精英联赛",
          "abbr_en": "ES",
          "logo": "/lol/series/264ca46b13871e6f6d9958cd451eb3b4.png"
        },
        "series": {
          "series_id": 35560,
          "name": "精英系列赛-比荷卢大师赛 2024",
          "name_en": "Elite Series-Benelux Masters 2024",
          "abbr": "精英系列赛-比荷卢大师赛",
          "abbr_en": "ESM",
          "logo": "/lol/series/3f617471aead1b565f27bee57268aa58.png",
          "status": "live"
        },
        "stage": {
          "stage_id": 9470,
          "name": "季后赛",
          "name_en": "Playoffs",
          "mode": 2
        },
        "start_time": 1731262049,
        "end_time": 1731263049,
        "bo": 5,
        "level": 4,
        "status": "past",
        "menu": [
          0,
          1,
          0,
          1
        ],
        "teams": [
          {
            "side": 1,
            "win_rate": 0.46,
            "score": 3,
            "team_info": {
              "team_id": 41105,
              "name": "SNOOZE esports",
              "name_en": "SNOOZE esports",
              "abbr": "SNZ",
              "abbr_en": "SNZ",
              "logo": "lol/team/86e122cb6d7a43501cf547522c213a10.png"
            }
          },
          {
            "side": 2,
            "win_rate": 0.54,
            "score": 2,
            "team_info": {
              "team_id": 29011,
              "name": "ZennIT",
              "name_en": "ZennIT",
              "abbr": "ZNT",
              "abbr_en": "ZNT",
              "logo": "/lol/team/47e700cc061992dd11071fb8d6d95461.png"
            }
          }
        ],
        "win_team": 41105,
        "race_list": [
          {
            "race_id": 535803,
            "stage": 1,
            "start_time": 1725094511,
            "end_time": 1725096455
          },
          {
            "race_id": 535811,
            "stage": 2,
            "start_time": 1725094511,
            "end_time": 1725096455
          }
        ],
        "update_time": 1731276815
      }
    ],
    "total": 1
  },
  "msg": "success"
}