获取逐球比赛文字解说,可按局筛选
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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 搭建可切换局次的文字比赛中心,通过在第一局和第二局之间切换 iid 来展示不同局的解说。
- 制作实时滚动播报:记录已收到的最新时间戳,并通过 tms 请求更多条目,上线前请先用自己的比赛数据验证翻页方向。
- 从解说中提取 WICKET 事件,在赛后报道里与记分卡并排绘制出局时间线。
- 把解说文本接入内部检索或摘要流程供分析师使用,前提是你已确认自己对这些文本拥有使用权。
- 在自定义解说页面中,通过 commentaryformats 解析 commtxt 里的 B0$ 类标记,渲染出加粗的重点文字。
常见问题
获取比赛解说必须传哪个参数?
只需要 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 以及击球或投球类型,返回的是与某一位球员相关的解说。