获取单局内某位球员相关的解说

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

返回一场比赛某一局中与单个球员相关的解说行。四个输入都是必填项:路径中的 matchId、表示局次的 iid、表示球员的 playerId,以及取值为 batting 或 bowling 的 type。这里列出的响应字段来自被截断的源示例,并未经过实时调用验证。comwrapper 数组中的每一项带有 commentary 对象,包含 commtxt、eventtype、inningsid、overnum、ballnbr、timestamp 和 commentaryformats,另外还有 appindex 对象(seotitle、weburl)。在示例中,eventtype 为 over-break 的条目还包含 oversep 对象,其中有场上 strike 与 non-strike 两位击球手的姓名和数据、投球手的姓名和数据,以及 battingteamname、oversummary、runs、score、wickets、ovrbatnames 和 ovrbowlnames。能否取到内容取决于比赛本身,以及该球员在所选局中是否参与了击球或投球。

API 功能

四项输入锁定球员 matchId、iid、playerId 和 type 全部必填,请求明确指向某一局中的某一位球员,客户端无需再从整场解说中逐条扫描。
击球与投球双视角 type 参数接受 batting 或 bowling,同一个球员 ID 既可以当作击球手的击球经过来读,也可以当作投球手的投球段落来读。
回合结束汇总 在源示例中,over-break 条目带有 oversep 对象,包含场上两位击球手的信息、投球手数据,以及刚结束那一回合的 oversummary、runs、score 和 wickets。
与阵容 ID 衔接 playerId 取自同一 matchId 的比赛球队接口中的球员 ID,因此可以自然地接在阵容或记分卡查询之后调用。
球位元数据 每一行都带有 overnum、ballnbr、inningsid 和 timestamp,应用可据此为球员的每次投球或击球排序,并把它们对应到记分牌上的位置。

在线 API 演示

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

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

查看价格

API 响应 (JSON)

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

使用场景

常见问题

获取球员解说需要哪些必填参数?

四个都需要:路径中的 matchId,以及查询参数 iid、playerId 和 type。示例值分别是 matchId 41881、iid 2、playerId 23016、type batting。

去哪里获取有效的 playerId?

使用同一 matchId 的比赛球队接口中列出的球员 id。不属于该场比赛的球员 id 不应期望返回有用的解说。

type 允许哪些取值?

batting 或 bowling。前者返回该球员作为击球手的解说,后者返回其作为投球手的解说。这两个值都是文档中给出的选项,没有列出其他角色取值。

响应中的 oversep 对象是什么?

在源示例中,eventtype 为 over-break 的条目带有 oversep 对象,包含 batstrikername、batstrikerdetails、batnonstrikername、batnonstrikerdetails、bowlname、bowldetails、battingteamname、oversummary、runs、score 和 wickets。这一内容来自源示例而不是实时调用,请在自己的调用中再核对一遍。

如果该球员在所选局中没有击球或投球会怎样?

目录中没有记录这种情况,所以结果可能为空或内容有限。请先根据记分卡选定局次和角色,并把缺失的 comwrapper 条目当作没有解说,而不是当作错误。

这个接口支持分页吗?

没有。该操作未记录任何分页参数,只接受 matchId、iid、playerId 和 type,因此需要翻阅整场解说时,请使用带 tms 参数的标准解说接口。

相关接口

相关指南

查看订阅方案 →