按 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 为球员资料页添加生涯时间线卡片,用 debut 与 lastPlayed 字符串列出各赛制的首秀和最近一次出场。
- 把 debutMatchID 和 lastPlayedMatchId 传给本产品的比赛级接口,让球员的首场与最近一场链接到对应的比赛页面。
- 发布前瞻稿之前检查时效:读取各赛制的 lastPlayed 日期,并隐藏显示为 Not played 的赛制。
- 为编辑整理人物背景笔记,记录每次首秀的对手、日期和球场,便于对照比赛记录核实事实。
- 做一个问答或冷知识功能,以自由文本的 debut 字符串作为答案来源,询问球员在哪里、对阵谁完成首秀。
常见问题
球员生涯接口会返回什么?
根据源 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 字段给条目建立索引,不要依赖数组位置。