获取比赛某一局的文字精彩片段(四分球、六分球、出局)

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

返回一场比赛某一局的精彩片段解说,也就是文字解说中与四分球、六分球和出局相关的段落。请求在 URL 路径中传入 matchId,另有必填的查询参数 iid(局次编号,例如 1)和可选的筛选参数 htype。htype 可取 0 表示全部条目,2 表示四分球,4 表示六分球,6 表示四分球与六分球合并,8 表示出局。省略 htype 时,目录将结果描述为四分球、六分球和出局;奇数的 htype 取值,其表现与比它小一位的偶数相同。本接口没有文档化任何响应字段:源示例是一个空的 JSON 对象,也没有做过实时调用,因此字段名称和条目结构都未经验证。建模之前,请先用你自己的 matchId 查看一次真实响应,并把结果当作文字解说而不是视频片段,因为没有任何媒体或播放字段被记录。百球大赛(The Hundred)有自己独立的精彩片段接口,本接口是标准赛制使用的路径。

API 功能

标准赛制精彩片段路径 为标准赛制比赛提供专门的精彩片段路径,普通比赛页面无需借助单独的百球大赛精彩片段接口,就能请求该场比赛的关键段落。
用 iid 指定局次 必填的 iid 参数用来选择具体的一局(目录中的示例为 1),客户端可以对同一个 matchId 的每一局分别发起请求,并把两局的列表各自独立保存。
通过 htype 筛选事件 可选的 htype 参数接受 0、2、4、6 或 8,分别对应全部条目、四分球、六分球、四分球与六分球合并、出局,一种请求结构就能同时覆盖边界球视图和出局视图。
不传 htype 时的混合默认值 不设置 htype 时,返回的是目录中的默认内容,即四分球、六分球和出局合在一起,无需自己选择筛选条件就是一份现成的关键时刻列表。
奇数 htype 向下取偶 目录说明奇数的 htype 取值表现与比它小一位的偶数相同,例如 5 会被当作 4 处理;为了让结果可预期,建议只使用文档列出的五个取值。
文字段落而非视频片段 本接口被描述为精彩片段解说,并未记录任何视频、图片或播放字段,所以适合做文字回顾,而不适合搭建片段播放器。

在线 API 演示

GET /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'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

哪些参数是必填的?

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)吗?

百球大赛有自己独立的精彩片段接口。百球大赛的比赛请使用那一个,本标准路径留给其他比赛,避免两类请求混用。

结果可能为空吗?

可能。唯一的源示例是一个空对象,而且数据覆盖情况取决于具体的比赛和局次,所以请把空响应或内容稀少的响应当作正常情形处理,而不是请求错误。

相关接口

相关指南

查看订阅方案 →