按 seriesId 获取板球系列赛积分榜,含球队排名、净胜率、近期战绩、列名图例和各队逐场比赛结果
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回单个板球系列赛的积分榜。seriesId 放在 URL 路径中(必填数字,默认值 7572 为文档示例值,其源示例对应 ICC Cricket World Cup League Two 2023-27),其 id 取自系列赛列表或系列赛归档接口的 id 字段。源文档中的 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)、保存毫秒级时间戳的 lastUpdatedTime 字符串、用键值对解释列名缩写(PTS、NRR、Q、E、P、W、L、NR、D)的 legend 数组,以及 pointsTable 数组。pointsTable 的每个条目带有 groupName(示例中为 Teams)和 pointsTableInfo 数组,数组里每支球队一个对象:teamId、teamFullName、teamImageId、matchesPlayed、matchesWon、matchesLost、noRes 和 points 为数字,nrr 为带符号的字符串(如 +0.677),form 数组为近期赛果字母(示例中为 W 或 L),另有 teamMatches 数组。teamMatches 的每个条目给出 matchId、matchName、opponent、opponentId、opponentSName、opponentImageId、赛果文本 result、毫秒级时间戳字符串 startdt、带符号字符串 nrrChanges 以及获胜球队 id winner。源文档还记录了返回空对象的 HTTP 204 响应,这是没有积分榜的系列赛的返回结果。该接口没有记录过实时探测,且所给的 200 示例在第一支球队的 teamMatches 列表中间被截断,后面的球队和其他字段看不到。这里描述的所有字段均来自源示例,未经独立验证。该表是赛事自身的积分排名,而不是全球排名。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/series-get-points-table API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/series-get-points-table?key=<API_KEY>&seriesId=7572'
查询结果
使用场景
- 在赛事页面的赛程和阵容旁增加积分榜标签页,根据 pointsTable 渲染各列,并用 legend 数组给列命名。
- 制作状态指引:把每支球队 form 数组中最近五个 W 和 L 字母画在积分榜对应行的旁边。
- 读取每个 teamMatches 条目上带符号的 nrrChanges 值,转换为数字后,绘制各队净胜率在整个赛季中的变化曲线。
- 当接口返回 HTTP 204 或空对象时显示无积分榜状态,而不是为没有排名的系列赛渲染一个空表格。
- 把 lastUpdatedTime 毫秒级时间戳字符串转换为用户的本地时间,在表格下方显示最近刷新时间标签。
- 将该表呈现为该赛事自身的积分排名,不要称其为 ICC 全球排名,也不要根据响应中没有记录的同分判定规则去推算出线概率。
常见问题
系列赛积分榜接口返回什么内容?
根据源文档的 200 示例,它返回 appIndex 对象、lastUpdatedTime 字符串、legend 数组,以及由多个分组组成的 pointsTable 数组,每个分组带有球队行的 pointsTableInfo 数组。该接口没有记录过实时探测,这些字段均来自源示例,未经独立验证。
它接受哪个参数?
只有 seriesId,必填,放在 URL 路径中,类型为数字,默认值为 7572。文档中没有查询参数。
seriesId 从哪里获取?
取自本产品的系列赛列表或系列赛归档接口返回的 id 字段,然后把同一个数字传到这里即可。
PTS、NRR、Q、E 等图例键是什么意思?
示例中的 legend 数组把 PTS 定义为积分(Points),NRR 为净胜率(Net Run Rate),Q 为已晋级(Qualified),E 为已淘汰(Eliminated),P 为已赛场次,W 为胜场,L 为负场,NR 为无结果(No Result),D 为取消资格(Disqualified)。示例的可见部分没有显示哪个球队字段带有 Q 或 E 标记,所以依赖它之前请先检查自己系列赛的响应。
每支球队的 teamMatches 数组里有什么?
每场计入的比赛一个条目,包含 matchId、matchName、opponent、opponentId、opponentSName、opponentImageId、类似 Won by 14 runs 的赛果文本 result、startdt 时间戳字符串、带符号的 nrrChanges 字符串以及获胜球队 id winner。可以用 matchId 继续调用本产品的比赛类接口。
HTTP 204 或空响应是什么意思?
源文档记录了返回空对象的 204 响应,这是没有积分榜的系列赛的返回结果。请把它当作无数据而不是错误,并在客户端显示无积分榜的提示。
哪些字段是数字,哪些是字符串?
示例中 matchesPlayed、matchesWon、matchesLost、noRes、points、teamId 和 matchId 是数字;nrr、nrrChanges、startdt 和 lastUpdatedTime 是字符串,所以带符号的小数和毫秒级时间戳需要在自己的代码中解析。
响应是否包含所有球队和分组?
所给的 200 示例在第一支球队的比赛列表中间被截断,所以后面的球队和其他分组在证据中看不到。覆盖范围取决于具体系列赛,请在客户端遍历每个 pointsTable 条目和每个 pointsTableInfo 项。