按 playerId 获取板球球员各赛制的生涯首秀与最近一次出场信息,含对手、日期、场地与比赛 ID

查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →

按比赛赛制返回球员的生涯节点。唯一的输入是 playerId,它是必填数字,通过 URL 路径传入(默认值 8733 是文档中的示例值)。源文档中的 200 示例是一个对象,包含 appIndex 对象(seoTitle 与 webURL 字符串)和 values 数组,每个赛制对应一个条目。每个条目都有 name(示例中为 t20、test、odi、ipl 和 cl)、debut 字符串和 lastPlayed 字符串;球员出场过的赛制还会带有以数字字符串表示的 debutMatchID 和 lastPlayedMatchId。debut 和 lastPlayed 是自由文本,格式为对手、日期(YYYY-MM-DD)和场地,例如以 vs 开头再接球队名称的一行;示例中第一个逗号后面有两个连续空格。对于球员从未出场的赛制,示例在 debut 和 lastPlayed 中都显示文本 Not played,并且不包含这两个比赛 ID 字段。条目顺序在文档中没有规定,两个比赛 ID 键的拼写也不一致(debutMatchID 与 lastPlayedMatchId),所以请严格按返回的键名读取。该接口没有记录过实际探测调用,因此这里描述的所有响应字段都来自源示例,并未经过独立验证。该接口提供的是首秀与最近出场的标记,而不是逐场比赛历史或生涯总数据。

API 功能

每个赛制一个条目 values 数组为每个赛制提供一个独立对象(源示例中为 t20、test、odi、ipl 和 cl),生成生涯概览只需一次请求,不用再合并各赛制的多次调用。
带对手与场地的首秀描述 debut 字符串把对手、ISO 风格的日期和球场组合在一起,可以直接作为首次出场时间线的说明文字,无需再做第二次查询。
最近出场标记 lastPlayed 沿用同样的对手、日期和场地格式,客户端可以展示球员在各赛制最近一次入选的时间,并据此判断这条记录是否还算新。
可用于后续查询的比赛 ID debutMatchID 和 lastPlayedMatchId 是标识具体比赛的数字字符串,页面可以借此把首秀或最近一场与比赛级数据关联起来。
明确的 Not played 标记 球员从未出场的赛制会在 debut 和 lastPlayed 中带有文本 Not played,并且没有比赛 ID 字段,因此“没打过该赛制”可以和“数据缺失”区分开。
单参数请求 只需要 playerId,没有系列赛、赛制或分页输入需要配置,所以生涯数据很容易以单个球员为键做缓存。
与统计表分工明确 该接口只返回带日期的生涯节点,与球员资料页上的击球表和投球表互为补充,不会重复它们的统计数字。

在线 API 演示

GET /api/project/cricbuzz-cricket/players-get-career

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/players-get-career?key=<API_KEY>&playerId=8733'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

球员生涯接口会返回什么?

根据源 200 示例,返回 appIndex 对象和 values 数组,数组中每个赛制一个对象。每个对象包含 name、debut 和 lastPlayed;球员在该赛制出场过时,还包含 debutMatchID 和 lastPlayedMatchId。该接口没有记录过实际探测调用,所以这些字段并未经过独立验证。

唯一的输入是什么?

playerId,必填数字,放在 URL 路径中,默认值为 8733。它取自热门球员或球员搜索接口返回的 id 字段。该接口没有赛制、系列赛或分页参数,所以所有赛制都在同一个响应中返回。

debut 和 lastPlayed 字符串里有什么?

它们是自由文本,如源示例所示,由对手、写成 YYYY-MM-DD 的日期和场地组成,并用逗号分隔。示例中第一个逗号后有两个连续空格,所以在展示或拆分字符串之前请先去除多余空白。

Not played 是什么意思?

对于球员从未出场的赛制,示例会在 debut 和 lastPlayed 中都给出文本 Not played,并省略 debutMatchID 和 lastPlayedMatchId 字段。在生成链接或解析日期之前,请先检查这段文本和缺失的键。

比赛 ID 能用在其他接口吗?

它们以数字字符串形式标识首秀和最近出场的那两场比赛,可以传给本产品的比赛级接口。不过覆盖范围取决于数据源,较早的比赛页面仍然可能返回空内容。

为什么比赛 ID 的键名看起来不一致?

源示例中的拼写是 debutMatchID 和 lastPlayedMatchId,两者 Id 的大小写不同。请严格按原样读取每个键,严格模式的客户端不要依赖忽略大小写的匹配。

响应包含生涯总数据或逐场比赛历史吗?

不包含。文档中的字段只有各赛制的首秀与最近出场标记。具体数字请使用击球和投球统计接口,也不要把这个响应当作完整的比赛事件记录来展示。

赛制条目的顺序是固定的吗?

文档中没有说明顺序固定。示例把 t20 排在 test 和 odi 之前,所以请按 name 字段给条目建立索引,不要依赖数组位置。

相关接口

相关指南

查看订阅方案 →