获取百球大赛某一局中单个击球手或投球手的解说
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 根据 playerId 和局次搭建以球员为中心的百球大赛赛后回顾,按球的先后顺序列出该击球手或投球手自己的解说行。
- 当用户从百球大赛球员研究页打开解说时,沿用百球大赛专用的请求路径,而不是退回标准赛制的球员解说接口。
- 在球员资料页中读取 FOUR、SIX、WICKET 等 eventtype 值,为某一局提取单个击球手的边界球与出局解说。
- 请求 type 为 bowling 并读取 oversep 小结,把投球手的一段投球展示成逐轮列表,上线前请先在真实百球大赛比赛里核对轮次的编号方式。
- 在编辑工作流中,把单个球员的文字时间线放到百球大赛记分卡旁边,并按 timestamp 数值排序各行解说。
常见问题
哪些参数是必填的?
四个都是必填。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 只出现在换局条目中,而示例里的媒体字段取值为零或空字符串。