查询足球比赛状态
查看 足球数据 API：赛程、比分与积分榜 的全部接口 →传入必填 eventid，读取单场状态并评估应用自身的刷新逻辑。本专用状态响应尚未验证，应独立确认真实状态字段，不能直接套用比赛详情中的 started 和 finished。明确处理未知、缺失及取消状态，不假设固定枚举或保证实时交付。
API 功能
专用状态读取按比赛定位 用选中的 eventid 请求状态，不依赖名称查找。
应用标签基于真实状态值 仅将实际确认的返回值映射为用户可读标签。
未知状态保持可辨识 保留未识别状态，不悄悄改成未开赛或已结束。
刷新生命周期依据语义评估 核验状态后再决定关注比赛的任务何时继续或停止。
在线 API 演示
未找到可用的 API Key，请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/football/get-match-event-status-by-event-id API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-status-by-event-id?key=<API_KEY>&eventid=5868072'
curl -X GET 'https://api.opendata-api.com/api/project/football/get-match-event-status-by-event-id?key=<API_KEY>&eventid=5868072'
查询结果
需要帮助？
如遇接口异常，或需要其他接口需求，可联系我们
使用场景
- 建立先记录原始状态、再转换界面标签的比赛刷新任务。
- 在经过确认的状态映射判定完赛后暂停后续刷新。
- 测试未知或不可用状态的展示，不擅自声称比赛已经取消。
- 调查专用状态响应与比赛详情快照之间的不一致。
常见问题
状态查询使用哪个 ID？
使用搜索或赛程中确认的比赛 ID 填写 eventid，不是球队或联赛标识。
可以固定认为会返回 started 和 finished 吗？
不可以。它们在详情等已验证样例中出现过，但此专用状态接口尚无样例，需单独核实字段与枚举。
未知状态应该显示取消吗？
不应该。应区分未知、缺失、取消和已结束，并保留原始状态以便调查；该接口也不保证实时交付。