获取比赛某一局的文字精彩片段(四分球、六分球、出局)
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回一场比赛某一局的精彩片段解说,也就是文字解说中与四分球、六分球和出局相关的段落。请求在 URL 路径中传入 matchId,另有必填的查询参数 iid(局次编号,例如 1)和可选的筛选参数 htype。htype 可取 0 表示全部条目,2 表示四分球,4 表示六分球,6 表示四分球与六分球合并,8 表示出局。省略 htype 时,目录将结果描述为四分球、六分球和出局;奇数的 htype 取值,其表现与比它小一位的偶数相同。本接口没有文档化任何响应字段:源示例是一个空的 JSON 对象,也没有做过实时调用,因此字段名称和条目结构都未经验证。建模之前,请先用你自己的 matchId 查看一次真实响应,并把结果当作文字解说而不是视频片段,因为没有任何媒体或播放字段被记录。百球大赛(The Hundred)有自己独立的精彩片段接口,本接口是标准赛制使用的路径。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-highlights API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-highlights?key=<API_KEY>&matchId=41881&iid=1'
查询结果
使用场景
- 为选定的一局撰写四分球与出局的文字回顾:传入受支持的 htype 取值,或省略 htype 以使用默认的混合内容。
- 帮助编辑在撰写比赛报道之前,快速定位某一局的关键段落,同时不要把这些文字精彩片段当作视频内容来展示。
- 为偏重击球表现的简报增加只含六分球的列表:针对要回顾的那一局传入 htype 4。
- 在记分卡页面旁边展示只含出局的板块:对每一局各请求一次 htype 8。
- 对文档列出的五个 htype 取值做集成测试,并对比奇数取值(例如 3)与其下方偶数取值的表现是否一致。
常见问题
哪些参数是必填的?
matchId(URL 路径)和 iid(查询参数)是必填的,htype 是可选的。默认值为 matchId 41881、iid 1。
htype 的各个取值代表什么?
0 返回全部条目,2 为四分球,4 为六分球,6 为四分球与六分球合并,8 为出局。目录只列出这五个取值,并说明奇数取值表现与比它小一位的偶数相同。
不传 htype 会得到什么?
目录将默认值描述为四分球、六分球和出局。这是一份混合的关键时刻视图,与 0(全部条目)并不相同。
matchId 从哪里获取,iid 又是什么?
matchId 可从比赛列表、赛程、系列赛、球队或场地的比赛接口中取得。iid 是局次 ID,目录示例为 1;目录没有进一步说明存在哪些局次编号,所以请求更靠后的局次之前,请先核对这场比赛。
响应里包含哪些字段?
没有任何文档化字段。源示例是一个空的 JSON 对象,也没有做过实时调用,所以字段名称和条目结构都未经验证。编写解析器之前,请先用你的 matchId 查看一次真实响应。
它会返回视频片段吗?
没有记录任何媒体字段。该接口被描述为精彩片段解说,请按文字段落来规划,不要承诺提供片段、播放或视频转载。
可以用它查询百球大赛(The Hundred)吗?
百球大赛有自己独立的精彩片段接口。百球大赛的比赛请使用那一个,本标准路径留给其他比赛,避免两类请求混用。
结果可能为空吗?
可能。唯一的源示例是一个空对象,而且数据覆盖情况取决于具体的比赛和局次,所以请把空响应或内容稀少的响应当作正常情形处理,而不是请求错误。