按比赛 ID 获取足球比赛详情
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →使用搜索或赛程返回的 eventid，查询比赛身份、双方球队、联赛背景、UTC 开赛时间及开始结束标志。已验证的 5868072 返回 response.detail，包含 matchId、matchName、matchRound、leagueId、leagueName、leagueRoundName、parentLeagueId、countryCode、homeTeam、awayTeam、matchTimeUTCDate、started 和 finished，也出现 teamColors 与 coverageLevel。该德比赛例已结束；coverageLevel='xG' 只是覆盖级别标签，不是预期进球数。此详情样例未包含最终比分。
API 功能
核对选中比赛的身份 用 matchId 和 matchName 检查详情是否对应用户选择的赛程。
解析双方球队资料入口 已验证 homeTeam 与 awayTeam 提供球队名称和 id，可继续关联俱乐部页。
赛事与轮次组成比赛抬头 leagueId、leagueName 及轮次标签减少只靠名称关联造成的歧义。
保留开赛与完赛背景 matchTimeUTCDate、started、finished 说明已验证比赛的时间和完成状态。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-match-event-detail-by-event-id API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-detail-by-event-id?key=<API_KEY>&eventid=5868072'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-detail-by-event-id?key=<API_KEY>&eventid=5868072'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 使用已验证的马德里德比数据制作球队、联赛与开赛时间组成的比赛页标题区。
- 发布战报前，对照详情中的球队 ID 核查已保存的赛程记录。
- 利用 homeTeam.id 和 awayTeam.id 从比赛页分别跳转到两队资料。
- 采集时保留覆盖标签，不凭空补出缺失的 xG 数值或最终比分。
常见问题
比赛详情需要的 eventid 从哪里获取？
先调用比赛搜索或赛程列表，选定目标对阵后使用其比赛 ID。5868072 是已验证的公开比赛示例；不要以球队或联赛 ID 代替。
coverageLevel 为 xG 就能读到预期进球吗？
不能。已验证详情中的 xG 是覆盖级别标签，不是数值字段；要展示技术统计，必须另查统计接口并核实实际返回的指标。
详情里一定有最终比分吗？
不一定。已验证的已结束比赛详情没有最终比分，应使用赛程中的已验证比分字段，或先核验单场比分接口的格式。