获取百球大赛某一局的文字精彩片段
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →通过专为 The Hundred(百球大赛)赛制保留的路径,返回一场比赛某一局的精彩片段解说。请求需要在路径中传入 matchId,必填的 iid(局次编号),以及可选的 htype 筛选:0 返回全部条目,2 为四分球,4 为六分球,6 为四分球加六分球,8 为出局。省略 htype 时,目录将结果描述为四分球、六分球和出局;取奇数的 htype 与比它小的那个偶数效果相同。该接口没有文档化的响应字段:源示例是一个空的 JSON 对象,也没有做过实时调用,所以字段名称和条目结构都未经验证。在建模之前,请先针对一场真实的百球大赛比赛查看实际响应,并把结果当作文字解说而不是视频片段,因为文档中没有任何媒体或播放字段。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/match-details-get-highlights-hundred API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/match-details-get-highlights-hundred?key=<API_KEY>&matchId=40381&iid=1'
查询结果
使用场景
- 使用经过验证的 htype 值,为所选局次准备一份百球大赛比赛的分局文字集锦回顾。
- 在百球大赛比赛页面上提供能区分赛制的文字回顾,同时不暗示这个解说接口提供视频片段或播放权利。
- 为赛后总结搭建只含出局的时间线,对每一局各请求一次 htype 8 即可。
- 在百球大赛比赛中心里做一个边界球标签页,针对所选局次用 htype 6 把四分球和六分球合并列出。
- 撰写追分与守分的对比稿时,用不同的 iid 值调用两次,对比第一局与第二局的关键时刻。
常见问题
哪些参数是必填的?
URL 路径中的 matchId 和作为查询参数的 iid(局次编号)是必填的,htype 是可选的。默认值为 matchId 40381 和 iid 1。
htype 的各个取值分别代表什么?
0 返回全部条目,2 返回四分球,4 返回六分球,6 同时返回四分球和六分球,8 返回出局。奇数取值与比它小的偶数效果相同,因此 5 的行为和 4 一样。
不传 htype 会得到什么?
目录将默认结果描述为四分球、六分球和出局。这与文档中说明为全部条目的 htype 0 不同,所以想要所有内容时,请显式传入 0。
响应里包含哪些字段?
没有任何文档化的字段。源示例是一个空的 JSON 对象,也没有做过实时调用,所以条目结构未经验证。请针对一场真实的百球大赛比赛调用并查看结果,再来为字段建模。
它会返回视频片段吗?
该接口被描述为精彩片段解说,文档中没有任何视频、媒体或播放字段,所以请把它当作文字内容。不要凭这个路径承诺提供视频片段或再分发权利。
什么时候应该用它而不是标准的精彩片段接口?
当 matchId 属于以 The Hundred 赛制进行的比赛时使用它。这是针对该赛制的专用路径,能让百球大赛的回顾与标准赛制的精彩片段请求保持分开。
结果可能为空吗?
可能,请提前做好处理。示例本身就是一个空对象,而且数据覆盖情况取决于具体的比赛和局次,所以应当显示“暂无精彩片段”的状态,而不是假定一定存在条目。