获取百球大赛某一局中单个击球手或投球手的解说

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

通过专为 The Hundred(百球大赛)赛制保留的路径,返回一场比赛某一局中与指定球员相关的文字解说。请求需要在路径中传入 matchId,并提供三个必填查询参数:iid(局次编号)、playerId(参加该场比赛的球员,可通过比赛球队接口查到)以及 type,type 必须是 batting 或 bowling,用来选择该球员是作为击球手还是投球手。这里列出的响应字段来自一份被截断在 4000 个字符处的源示例,并未经过实时调用验证。示例中有 appindex 对象(seotitle、weburl)和 comwrapper 数组;comwrapper 的每一项都带有 commentary 对象,包含 commtxt、eventtype(NONE、FOUR、WICKET,或 over-break,SIX 这类组合值)、inningsid、overnum、ballnbr、batteamscore、boundarytracker、timestamp、commentaryformats(B0$、B1$ 之类的加粗 id 与 value 键值对),以及媒体引用字段(videoid、videotype、videourl、premiumvideourl、imageid、planid、ispremiumfree)。每个换局(over-break)条目还会带 oversep 对象,包含 oversummary、runs、wickets、score、batstrikername、batnonstrikername、battingteamname、bowlname 和 bowldetails。默认值(matchId 40381、iid 1、playerId 11131、type batting)对应的示例,其解说内容描述的是一场每轮六球的 T20I,因此该示例并不能代表有数据的百球大赛解说流。请把所有字段都当作可选字段处理。

API 功能

百球大赛专属球员路径 专门的路径把解说限定到 The Hundred 赛制中的某一位球员,百球大赛的球员页面可以保留自己独立的请求,而不会悄悄调用标准赛制的球员解说接口。
击球手与投球手角色切换 必填的 type 参数接受 batting 或 bowling,同样的 matchId、iid 和 playerId,可以按你选择的角色返回该球员面对的球或他投出的球。
四个输入全部必填 matchId、iid、playerId 和 type 都是必填项,每次请求都明确指向一场比赛、一局、一名球员和一种角色,不存在需要额外处理的不带筛选的兜底情形。
带事件标签的逐球条目 每条解说都带有 eventtype(源示例中可见 NONE、FOUR、WICKET 和 over-break,SIX)以及 overnum、ballnbr 和毫秒级 timestamp,方便快速挑出四分球、六分球和出局。
换局小结区块 换局条目包含 oversep 对象,附带该轮的 oversummary 文本、得分、出局数、当前比分、两名击球手和投球手的数据,为击球手或投球手视图提供现成的逐轮回顾。
基于标记的加粗文本 commtxt 中可能含有 B0$ 之类的标记,对应 commentaryformats 里的 id 与 value 键值对,客户端可以据此把 out、FOUR 或出局说明等字样渲染成加粗。

在线 API 演示

GET /api/project/cricbuzz-cricket/match-details-get-player-commentaries-hundred

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-player-commentaries-hundred?key=<API_KEY>&matchId=40381&iid=1&playerId=11131&type=batting'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

哪些参数是必填的?

四个都是必填。matchId 放在 URL 路径中,iid、playerId 和 type 是必填的查询参数。默认值为 matchId 40381、iid 1、playerId 11131、type batting。

playerId 从哪里获取?

使用同一场比赛中某位球员的 id,可通过该 matchId 对应的比赛球队接口查到。示例中的 playerId 11131 就是示例解说行里出现的那位球员;没有参加该场比赛的球员不是有意义的取值。

type 可以取哪些值?

只能是 batting 或 bowling。batting 选择该球员作为击球手的解说,bowling 选择该球员作为投球手的解说。其他任何值都不在文档说明的选项之内。

它与标准的球员解说接口有什么区别?

二者的输入结构相同,但本接口是专为 The Hundred 赛制保留的路径。当 matchId 属于百球大赛的比赛时请使用它,这样你的百球大赛球员视图就不会与标准赛制的请求混在一起。

示例展示的是真实的百球大赛数据流吗?

不是。该示例对应默认的 matchId 40381,解说行描述的是一场 T20I,overnum 的取值如 18.5,所以它只能说明响应结构。示例同样被截断在 4000 个字符处,也没有经过实时调用验证。

能根据 overnum 推断五球一组或 100 球的计数逻辑吗?

不能。目录没有说明 overnum 和 ballnbr 如何对应 100 球赛制,示例采用的是六球一轮的编号方式。在搭建计分或轮次逻辑之前,请先在真实的百球大赛比赛里验证这些数值。

哪些字段应当视为可选?

全部字段。数据覆盖情况取决于比赛,某位球员可能只有很少甚至没有解说行,oversep 只出现在换局条目中,而示例里的媒体字段取值为零或空字符串。

相关接口

相关指南

查看订阅方案 →