足球重要事件接口

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

必需

app_secret

string

用户秘钥

必需

示例代码

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"
}