按类别(击球手、投手、全能球员或球队)、赛制(Test、ODI 或 T20)以及男子或女子榜单获取 ICC 板球排名
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回一张 ICC 排名表。category 通过 URL 路径传入(必填字符串:batsmen、bowlers、allrounders 或 teams,默认值为 batsmen),formatType 通过查询字符串传入(必填字符串:test、odi 或 t20,默认值为 t20)。加上 isWomen=1 即可请求女子榜单;参数说明指出,isWomen 为 1 时没有 odi 榜单。响应是一个对象,包含 rank 数组和 appIndex 对象(seoTitle 与 webURL 字符串)。针对 category 为 batsmen、formatType 为 t20 的一次实际探测返回了 HTTP 200 和同样的结构,rank 中有 15 个条目,排名相关字段均为字符串。实测结果和源示例中的条目都带有 id、rank、name、country、countryId、faceImageId、rating、points、lastUpdatedOn(YYYY-MM-DD 日期)和 trend(Flat、Up 或 Down)。整数类型的 difference 字段(源示例中为 1 或 -2 这样的带符号变化值)只出现在部分条目中。排名是字符串,而且可以并列:源示例中有两名球员同为第 5 名,下一名则从第 7 名继续。示例中的 seoTitle 提到前 100 名榜单,但示例和探测结果都只有 15 个条目,所以列表长度并未被文档说明为固定值。只探测过 batsmen 加 t20 这一种组合;投手、全能球员、球队、其他赛制以及女子榜单的条目字段没有经过验证,尤其是球队条目可能不带球员字段。数据覆盖范围和更新日期取决于数据源。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/stats-get-icc-rankings API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/stats-get-icc-rankings?key=<API_KEY>&category=batsmen&formatType=t20'
查询结果
使用场景
- 搭建 ICC 排名页面:用类别标签、赛制选择器和男女切换分别对应 category、formatType 与 isWomen。
- 在球队或赛事专题页放一个顶级击球手组件,列出名次、姓名、国家和评分,并通过 id 链接到球员资料。
- 每天保存 rating 与 lastUpdatedOn 快照来追踪排名变动,再用 trend 和 difference 字段突出上升和下滑的球员。
- 制作女子板球排名说明页:打开 isWomen 并隐藏 ODI 选项,遵循文档中记录的限制。
- 按 countryId 对排名行分组,先把字符串评分转成数字,再比较各国在选定赛制中有多少名球员进入榜单前列。
常见问题
ICC 排名接口会返回什么?
返回一个包含 rank 数组和 appIndex 对象的对象。针对 category 为 batsmen、formatType 为 t20 的一次实际探测返回了 HTTP 200 和 15 个条目,每个条目都有 id、rank、name、country、countryId、faceImageId、rating、points、lastUpdatedOn 和 trend,部分条目还带有整数 difference。
哪些参数是必填的?
URL 路径中的 category 和查询字符串中的 formatType 是必填字符串。category 可取 batsmen、bowlers、allrounders 或 teams,formatType 可取 test、odi 或 t20。isWomen 是选填参数,传 1 即可获得女子榜单。
女子榜单有 ODI 吗?
根据参数说明,没有。isWomen 为 1 时不存在 odi 榜单,所以女子榜单的选择器只提供 test 和 t20;如果仍然发送了 odi,请处理好空响应或错误响应。
rank、rating 和 points 是数字吗?
在探测结果和源示例中它们都是字符串,例如 rank、rating 和 points。排序或计算之前请先显式转换;如果只用于展示,直接保留原字符串即可。
两个条目可以并列同一名次吗?
可以。源示例中有两名球员同为第 5 名,下一名是第 7 名。不要把 rank 当作唯一键,球员请用 id 区分,展示时则保持数组原有顺序。
difference 什么时候出现?
整数 difference 字段只出现在部分条目上,通常与取值为 Up 或 Down 的 trend 一起出现,而示例中没有变化的条目 trend 为 Flat 且没有 difference。请把它当作可选字段,缺失时按没有变化处理。
投手、全能球员、球队和女子榜单测试过吗?
没有。只探测过 batsmen 加 t20。其他类别、其他赛制和女子榜单的条目字段都没有经过验证,球队条目也可能与球员条目不同,所以绑定球队榜单之前请先检查一次真实响应。
返回的列表有多长?
长度没有被文档说明为固定值。虽然示例标题提到前 100 名榜单,但探测结果和源示例都只有 15 个条目,所以页面应当能渲染实际返回的任意数量的行。