按类别(击球手、投手、全能球员或球队)、赛制(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 功能

四种排名类别 路径中的 category 值可选 batsmen、bowlers、allrounders 或 teams,一个接口就能覆盖数据源所记录的每一种排名表。
Test、ODI 与 T20 榜单 必填的 formatType 查询值可选 test、odi 或 t20,排名页面只需更换一个参数就能切换赛制。
女子榜单开关 把 isWomen 设为 1 即可获得女子榜单,参数说明指出该榜单没有 odi 选项,所以赛制选择器可以据此禁用这个组合。
每个条目的评分、积分与趋势 每个排名条目带有 rating、points 以及取值为 Flat、Up 或 Down 的 trend,部分条目还有整数 difference,足以在名次旁画出升降箭头。
便于跳转的关联标识 条目返回 id、countryId 和 faceImageId,球员行可以链接到本产品的球员资料和图片接口,国家也可以直接按 countryId 分组而不必匹配名称。
每行带更新日期 lastUpdatedOn 字段为每个条目给出 YYYY-MM-DD 日期,页面可以据此显示榜单的新鲜程度,并发现排名何时发生了变化。
已实测的排名响应结构 针对 batsmen 加 t20 的一次实际探测返回了 HTTP 200,以及 rank 数组和 appIndex 对象,所以主要结构是实测得到的,而不只是文档说明。

在线 API 演示

GET /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 排名接口会返回什么?

返回一个包含 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 个条目,所以页面应当能渲染实际返回的任意数量的行。

相关接口

相关指南

查看订阅方案 →