按球队 ID 查询板球球队已完赛的比赛结果,按系列赛分组返回结果状态、对阵双方、场地与各局比分
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一支板球球队的历史比赛结果。唯一必填的路径参数是 teamId,即数字类型的球队 ID,取自球队列表接口返回的 teamId 字段,默认示例值为 2。根据源响应示例,返回内容包含带有导航信息的 appIndex 对象和 teamMatchesData 数组。结果条目使用 matchDetailsMap,其键为系列赛名称,并带有 match 数组和 seriesId。每场比赛的 matchInfo 包括 matchId、matchDesc、matchFormat、state、status、hideScoreStatus,以毫秒时间戳字符串表示的 startDate 与 endDate,seriesId、seriesName,含 teamId、teamName、teamSName 和 imageId 的 team1 与 team2,以及含 id、ground、city 和 timezone 的 venueInfo;有比分数据时还会带有 matchScore,给出每支球队各局的得分、出局数和回合数。数组中部分条目是广告位,只包含 adDetail 对象而没有比赛数据;示例里一场被放弃的比赛也没有 matchScore。本接口没有记录过实时探测,上述字段均来自未经验证、可能被截断的源示例。文档中也没有分页或日期范围参数。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/teams-get-results API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/teams-get-results?key=<API_KEY>&teamId=2'
查询结果
使用场景
- 填充所选球队的赛果标签页,并利用返回的 matchId 为每场结果打开比赛中心,提供更深入的背景信息。
- 制作球队赛果摘要,但不要假设可以查询无限长的历史区间,也不要使用文档中没有列出的分页控制。
- 读取球队最近几场已完赛比赛的状态文字和各局比分,做出一条近期状态条。
- 在移动应用中利用系列赛名称键和 seriesId,把球队近期赛果按巡回赛或锦标赛归类展示。
- 通过读取每条结果 venueInfo 中的球场、城市和时区,交叉核对按场地统计的历史战绩视图。
常见问题
teams-get-results 接口会返回什么内容?
返回 teamId 所指球队的比赛结果。源示例中的 teamMatchesData 条目按系列赛分组,每个条目带有 matchInfo,并在有数据时附带 matchScore 各局比分。
有效的 teamId 从哪里获取?
使用球队列表接口返回的 teamId 字段。预填的 2 只是默认示例值,该操作的源示例显示它返回的是名为 India 的球队的赛果。
可以按日期、系列赛或页码筛选结果吗?
文档中的输入只有 teamId,没有列出日期范围、系列赛筛选或分页参数,因此不要假设响应覆盖无限长的历史,也不要假设可以翻页获取更多数据。
为什么有些条目是 adDetail 而不是比赛数据?
源示例在各系列赛分组之间穿插了广告位对象。构建赛果列表时,请跳过没有 matchDetailsMap 的条目。
每场结果都会带比分吗?
不一定。源示例中一场因雨放弃的比赛只有状态文字,没有 matchScore,所以请把 matchScore 以及各局数据都当作可选字段处理。
这些字段是否经过实时探测确认?
没有。该操作没有记录过探测调用,字段列表来自可能被截断的源响应示例,依赖这些字段之前,请先用自己的请求验证真实的响应结构。