按 matchType 和可选的 seasonId 获取 ICC 世界测试锦标赛或世界杯超级联赛的球队积分榜。
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回 ICC 赛事的球队积分榜。matchType 是必填的路径数字,文档记录了两个取值:1 表示世界测试锦标赛,2 表示世界杯超级联赛。seasonId 是可选的查询数字:请使用本接口自身返回的 seasonStandings 数组中某个条目的 id;留空则由接口自行选择默认赛季,源文档没有说明默认选的是哪个赛季。源 200 示例是针对 matchType 2 记录的,包含三个部分:headers 是描述各列的字符串数组(Rank、Flag、Team、Points);seasonStandings 是由数字 id 和 name 组成的对象数组,示例中为 id 3、名称 ICC Men's Cricket World Cup Super League (2021 - 2023);values 是行对象数组,每行的 value 是与 headers 顺序一致的字符串数组,从第 1 名新西兰 175 分一直排到第 13 名荷兰 35 分。Flag 单元格是一个看起来像数字的字符串,疑似图片标识,尚未验证。该接口没有记录过实际探测调用,示例中的赛季不应被当作当前赛季。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/stats-get-icc-standings API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/stats-get-icc-standings?key=<API_KEY>&matchType=2'
查询结果
使用场景
- 在赛事专题页展示世界测试锦标赛或超级联赛的积分榜,表格列直接取自 headers 数组。
- 用 seasonStandings 生成赛季下拉菜单,并把用户选中的 id 作为 seasonId 重新加载积分榜。
- 制作晋级形势解读:按 Points 排序,并根据你自己的编辑规则标出排名分界线附近的球队。
- 按 matchType 与 seasonId 的组合各保存一份快照,积累一份记录 ICC 赛事积分榜变化的历史档案。
- 把赛事积分榜面板放在全球排名和系列赛积分榜组件旁边但保持独立,让读者分得清每个数字属于哪一种排名概念。
- 对同一张积分榜保存的两份快照做对比,找出排名上升或下降的球队,用于定期推送的简报或机器人消息。
常见问题
matchType 支持哪些取值?
源文档记录了两个:1 表示世界测试锦标赛,2 表示世界杯超级联赛。没有记录其他取值,因此不要假设还能查询其他赛制或赛事。
seasonId 从哪里获取?
从本接口响应中 seasonStandings 数组某个条目的 id 获取。在 matchType 2 的源示例中,该条目是 id 3,名称为 ICC Men's Cricket World Cup Super League (2021 - 2023)。先不带 seasonId 调用一次,就能看到赛季列表。
应该如何解读 values 数组?
每个条目都有一个字符串数组 value,各位置与 headers 数组一一对应,示例中依次为 Rank、Flag、Team、Points。请按 headers 的位置来映射单元格,并自行把 Rank 和 Points 转换成数字。
这和 ICC 球队排名是一回事吗?
不是。本接口返回的是某项 ICC 赛事(世界测试锦标赛或世界杯超级联赛)的积分榜。全球 ICC 排名来自本产品的 ICC 排名接口,系列赛积分榜则是另一类资源,请把它们放在不同的视图中。
Flag 列里是什么内容?
示例中新西兰的 Flag 是形如 776333 的数字字符串。它看起来是图片标识而不是 URL,但没有经过实际探测确认,所以在用它拼接图片链接之前,请先用图片接口验证。
示例展示的是当前积分榜吗?
不是。源 200 示例对应的是 2021 - 2023 世界杯超级联赛赛季,且没有记录过实际探测调用。请自行请求积分榜,并查看 seasonStandings 来确认实际返回了哪些赛季。