赛事列表 - 火星数据

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

请求参数

Query 参数

sport_id

string

可选

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

region_id

integer

根据地区ID筛选

可选

status

string

可选

赛事状态,未开始-upcoming，进行中-live，已结束-past，延期-delayed，取消-cancel，删除-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 {16}]

必需

total

integer

数据总条数

必需

msg

string

接口响应信息

必需

示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "sport_id": 201,
        "series_id": 12207,
        "region_id": 8,
        "league_id": 10605,
        "name": "中国女子青年篮球锦标赛U19",
        "name_en": "China Women's Youth Basketball Championship U19",
        "abbr": "中国女子青年篮球锦标赛U19",
        "abbr_en": "CBC U19",
        "year": 2021,
        "start_time": 1722787200,
        "end_time": 1725119999,
        "status": "past",
        "level": 4,
        "cover": "/201/1/f541c5224c7e7efbe6d77ec5c1360c30.png",
        "menu": [
          0,
          1,
          0,
          1,
          1,
          1,
          1,
          0,
          0
        ],
        "update_time": 1725290859
      },
      {
        "sport_id": 201,
        "series_id": 12241,
        "region_id": 0,
        "league_id": 9727,
        "name": "奥运会 三对三资格赛",
        "name_en": "Olympic Games Three-on-three qualifiers",
        "abbr": "奥运会 三对三资格赛",
        "abbr_en": "Olympic Games Three-on-three qualifiers",
        "year": 2021,
        "start_time": 1722787200,
        "end_time": 1722787200,
        "status": "past",
        "level": 99,
        "cover": "/201/1/f541c5224csdrrbe6d77ec5c1360c30.png",
        "menu": [
          0,
          1,
          0,
          1,
          1,
          1,
          1,
          0
        ],
        "update_time": 1725290859
      },
      {
        "sport_id": 201,
        "series_id": 12207,
        "region_id": 0,
        "league_id": 10402,
        "name": "2024年NBA选秀大会",
        "name_en": "2024 NBA Draft",
        "abbr": "2024年NBA选秀大会",
        "abbr_en": "NBA Draft",
        "year": 2024,
        "start_time": 1719417600,
        "end_time": 1719590399,
        "status": "past",
        "level": 1,
        "cover": "/201/1/f541c5224c7e7efbe6d77ec5sdv30c30.png",
        "menu": [
          0,
          1,
          0,
          1,
          1,
          1,
          1,
          0
        ],
        "update_time": 1725290859
      }
    ],
    "total": 3
  },
  "msg": "success"
}