比赛列表接口 - 火星数据

接口概述：
获取单个运动比赛赛程数据-自定义参数查询（不同项目的路径不同）
该接口返回所请求参数的全量赛程数据（请求限制：前后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-已结束，delayed-延期，abandoned-腰斩，cancel-取消，pending-待定，delete-删除

is_lot

integer

可选

是否是竞彩比赛，0-否 1-是

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

必需

total

integer

总条数

必需

msg

string

接口响应信息

必需

示例

成功示例异常示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "sport_id": 202,
        "match_id": 2773518,
        "league": {
          "league_id": 518,
          "region_id": 105,
          "name": "美国职业大联盟联赛",
          "name_en": "United States Major League Soccer",
          "abbr": "美职业",
          "abbr_en": "MLS"
        },
        "series": {
          "series_id": 11479,
          "name": "美国职业大联盟联赛",
          "name_en": "United States Major League Soccer",
          "abbr": "美职业",
          "abbr_en": "MLS",
          "year": 2024
        },
        "stage": {
          "stage_id": 4520,
          "name": "联赛",
          "name_en": "League",
          "mode": 1,
          "group_num": 0,
          "round_num": 26
        },
        "start_time": 1721266200,
        "end_time": 1721298200,
        "level": 1,
        "status": "past",
        "menu": [
          0,
          1,
          0,
          1,
          1,
          1,
          1,
          0,
          0
        ],
        "teams": [
          {
            "side": 1,
            "score": [
              1,
              2,
              3,
              4,
              5,
              6,
              7
            ],
            "team_info": {
              "team_id": 11482,
              "name": "纽约红牛",
              "name_en": "New York Red Bulls",
              "abbr": "Red Bull ",
              "abbr_en": "纽约红牛",
              "logo": "/202/1/1e4347af22869eb0e2a37f87a9a85458.png"
            }
          },
          {
            "side": 2,
            "score": [
              1,
              2,
              3,
              4,
              5,
              6,
              7
            ],
            "team_info": {
              "team_id": 8397,
              "name": "蒙特利尔CF",
              "name_en": "Montreal Impact",
              "abbr": "美职业",
              "abbr_en": "MLS",
              "logo": "/202/1/1e4347af22869eb0e2a37f87a9a85458.png"
            }
          }
        ],
        "environment": {
          "weather": 1,
          "pressure": 23.1,
          "temperature": 23.3,
          "wind": 5.5,
          "humidity": 30.4,
          "venue_id": 12,
          "referee_id": 10
        },
        "win_team": 0,
        "update_time": 1721273608
      }
    ],
    "total": 1
  },
  "msg": "success"
}