获取逐球比赛文字解说,可按局筛选

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

按 matchId 返回一场板球比赛的文字解说数据流。可通过 iid 只取某一局的解说,也可以把上一次返回条目的毫秒级时间戳作为 tms 传入来翻页;两者都留空时加载第一页。这里列出的响应字段来自被截断的源示例,并未经过实时调用验证。comwrapper 数组中的每一项都带有 commentary 对象,包含 commtxt、eventtype(例如 NONE 或 WICKET)、inningsid、overnum、ballnbr、batteamscore、timestamp、commentaryformats,以及 videoid、imageid、videourl 等媒体引用字段。示例中还出现了 appindex 对象(seotitle、weburl)和 buzz 对象(applink、imageids、isbuzzenabled、position)。解说内容是否可用取决于具体比赛,请把所有字段都当作可选字段处理。

API 功能

按局筛选解说 传入 iid 即可只取某一局的解说;不传则请求不带局筛选的整场比赛数据流,同一个接口既能支撑整场视图,也能支撑分局标签页。
用 tms 时间戳翻页 可选的 tms 取返回条目 timestamp 字段中的毫秒级 epoch 时间戳,客户端据此请求下一页,而不必反复重新加载第一页。
带事件类型的逐球条目 每条解说都提供 eventtype(源示例中可见 NONE 和 WICKET)以及 overnum、ballnbr、inningsid,客户端可以把每一行定位到具体的局和球,并突出显示出局事件。
内嵌高亮标记 源示例中的 commtxt 含有 B0$、B1$ 之类的标记,它们对应 commentaryformats 里的 id 与 value 键值对,例如出局说明中的加粗文字。
媒体与付费标志位 条目带有 ispremiumfree、planid、videoid、imageid、videourl 等字段,应用可以识别某一行是否引用了媒体,而不必假设每场比赛都有可用媒体。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

获取比赛解说必须传哪个参数?

只需要 matchId,它以数字形式放在 URL 路径中,可从比赛列表、赛程、系列赛、球队或场馆的比赛接口返回的 matchId 字段获得,示例值为 41881。iid 和 tms 都是可选的查询参数。

如何加载下一页解说?

tms 留空时加载第一页;之后把返回条目 timestamp 字段中的毫秒级 epoch 时间戳传入 tms。目录中没有说明它返回的是更早还是更新的解说行。源示例里的条目是按从新到旧排列的,所以在围绕它搭建滚动播报之前,请先用自己的比赛验证实际行为。

iid 参数有什么作用?

iid 是局次 ID,例如 1。设置后,数据流只包含该局的解说;省略时不会发送局筛选条件。每条解说本身也会通过 inningsid 报告所属的局。

为什么 commtxt 里会出现 B0$ 这样的标记?

在源示例中,commtxt 含有 B0$、B1$ 之类的占位符,commentaryformats 则列出与之匹配的 id 和 value 键值对,例如加粗显示的 out 或 Lbw。需要格式化文本的客户端应当替换这些值,并在没有格式数据时回退到原始的 commtxt。

响应可能为空或不完整吗?

可能。解说内容取决于比赛及其覆盖情况,而且上面的字段列表来自被截断的源示例,并非实时调用的结果。请妥善处理缺失的数组和字段;对于以 The Hundred 赛制进行的比赛,请改用单独的 Hundred 解说接口。

它与按球员筛选的解说接口有什么区别?

本接口返回整场比赛或所选局的解说数据流;按球员筛选的接口则要求同时提供 iid、playerId 以及击球或投球类型,返回的是与某一位球员相关的解说。

相关接口

相关指南

查看订阅方案 →