按 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 功能

单个系列赛的积分排名 路径中的 seriesId 返回某一届赛事的积分榜,因此一个联赛及其往届赛季可以放在不同标签页中展示,行数据互不混淆。
分组的表格结构 pointsTable 数组是一组分组列表,每组带有 groupName 和球队的 pointsTableInfo 数组;示例中只有一个名为 Teams 的分组,客户端应遍历所有分组,而不要假定只有一个。
每队战绩、积分与净胜率 每个球队对象都带有 matchesPlayed、matchesWon、matchesLost、noRes、points 和 nrr 字符串,正是积分榜网格的核心列。
近期战绩字母 示例中每支球队行都有由 W 和 L 字母组成的 form 数组,可直接渲染为球队名称旁的近期赛果条。
缩写列名的图例 legend 数组把 PTS、NRR、Q、E、P、W、L、NR 和 D 等键映射为可读名称,列标题可以直接根据响应本身生成。
每队逐场比赛明细 teamMatches 列出每场计入的比赛,含对手、赛果文本、nrrChanges 和获胜方 id,可以说明球队是如何得到当前净胜率的。
最后更新时间戳 示例顶部的 lastUpdatedTime 是毫秒级时间戳字符串,页面可以在用户参考榜单之前展示数据的新鲜程度。
有文档说明的空结果 没有积分榜的系列赛被记录为返回空对象的 HTTP 204,客户端可以据此切换为明确的无积分榜提示。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

系列赛积分榜接口返回什么内容?

根据源文档的 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 项。

相关接口

相关指南

查看订阅方案 →