足球重要事件接口

接口概述：
获取足球比赛的重要事件数据-自定义参数查询（不同项目的路径不同）
该接口返回所请求参数的全量重要事件数据（请求限制：前后30天的赛程）

推荐请求
更新数据：
方案1：有需求时请求指定比赛的重要事件数据：
方案2：接推送，接收实时有变化的数据（长链接推送/实时数据增强版/事件数据推送）
频率限制：30次/min

请求参数

Query 参数

match_id

string

可选

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

示例值:

3091184

language

string

可选

多语言名称,详细参数看API指南（全局多语言），不传该参数默认返回英文

page

integer

页数

可选

per_page

integer

每页数据条数

可选

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

必需

total

integer

总条数

必需

秒级时间戳

msg

string

接口响应信息

必需

示例

{
  "code": 0,
  "data": {
    "list": [
      {
        "sport_id": 202,
        "match_id": 3091184,
        "event_data": [
          {
            "type": 9,
            "position": 1,
            "state": 12,
            "time": 2700,
            "event_time": 1720641876,
            "home_score": 1,
            "away_score": 0,
            "reason": 1,
            "result": 1,
            "player_info": {
              "player_id": 59719,
              "name": "Cole Palmer"
            },
            "in_player_info": {
              "player_id": 16295,
              "name": "Wout Weghorst"
            },
            "out_player_info": {
              "player_id": 7167,
              "name": "Donyell Malen"
            },
            "assist_player1_info": {
              "player_id": 59719,
              "name": "Cole Palmer"
            },
            "assist_player2_info": null
          }
        ],
        "update_time": 1734333653
      }
    ],
    "total": 1
  },
  "msg": "success"
}