足球 API比赛

足球比赛单条

调试凭证使用你的 API key

仅在本页使用，刷新后清除。在线调试会使用你的调用额度。

GET

/v1/soccer/matches/{match_id}

鉴权

APIKeyHeader

headerX-API-Key<token>

合作方 API key

路径参数

match_id*Match Id

查询参数

include?array<>

可选子数据：events 事件、lineups 阵容、stats 黄牌 / 红牌 / 角球（可重复传）

默认值[]

响应体

Successful Response

application/json

response

data*

资源本体

请求示例 CODE

curl -X GET "https://example.com/v1/soccer/matches/string" \  -H "X-API-Key: YOUR_API_KEY"

响应示例 JSON

{  "data": {    "id": "string",    "competition": {      "id": "string",      "name": "string",      "name_cn": "string",      "logo_url": "string",      "logo_dark_url": "string"    },    "season": {      "id": "string",      "name": "string"    },    "stage": {      "id": "string",      "name": "string",      "name_cn": "string",      "stage_type": "string"    },    "group": {      "id": "string",      "key": "string",      "name": "string",      "name_cn": "string"    },    "round": 0,    "home_team": {      "id": "string",      "name": "string",      "name_cn": "string",      "logo_url": "string"    },    "away_team": {      "id": "string",      "name": "string",      "name_cn": "string",      "logo_url": "string"    },    "status": "upcoming",    "match_time": "string",    "score": {      "home": 0,      "away": 0,      "ht_home": 0,      "ht_away": 0,      "et_home": 0,      "et_away": 0,      "ps_home": 0,      "ps_away": 0,      "agg_home": 0,      "agg_away": 0    },    "stadium": "string",    "referee": "string",    "attendance": 0,    "weather": "string",    "temperature": "string",    "is_neutral": true,    "note": "string",    "home_formation": "string",    "away_formation": "string",    "motm": {      "player": {        "id": "string",        "name": "string",        "name_cn": "string"      },      "rating": 0    },    "has_lineups": true,    "has_stats": true,    "events": [      {        "minute": 0,        "added_time": 0,        "type": "goal",        "side": "home",        "player": {          "id": "string",          "name": "string",          "name_cn": "string"        },        "related_player": {          "id": "string",          "name": "string",          "name_cn": "string"        },        "note": "string",        "xg": 0,        "goal_description": "string",        "card_type": "string",        "card_description": "string",        "score": {          "home": 0,          "away": 0        }      }    ],    "lineups": {      "home_formation": "string",      "away_formation": "string",      "home": [        {          "id": "string",          "name": "string",          "name_cn": "string",          "shirt_number": "string",          "position_group": "GK",          "role": "starter",          "rating": 0,          "country": "string",          "photo_url": "string",          "formation_x": 0,          "formation_y": 0        }      ],      "away": [        {          "id": "string",          "name": "string",          "name_cn": "string",          "shirt_number": "string",          "position_group": "GK",          "role": "starter",          "rating": 0,          "country": "string",          "photo_url": "string",          "formation_x": 0,          "formation_y": 0        }      ]    },    "stats": {      "home": {        "yellow_card": 0,        "red_card": 0,        "corners": 0      },      "away": {        "yellow_card": 0,        "red_card": 0,        "corners": 0      }    },    "updated_at": "string"  }}

足球比赛列表

足球单场统计

足球比赛单条

鉴权复制标题链接

路径参数复制标题链接

查询参数复制标题链接

响应体复制标题链接

鉴权

路径参数

查询参数

响应体