获取单局内某位球员相关的解说
查看 板球数据 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 在球员主页上,让读者打开该球员在指定比赛、指定局中的相关解说。
- 针对某个 playerId 请求 type 为 batting,按顺序读完他面对的每一球,生成聚焦单个击球手的回顾。
- 用 type 为 bowling 构建投球手的投球段落拆解,借助 oversep 汇总逐回合展示失分与获得的出局数。
- 在赛后文章里,把记分卡与该球员自己的解说行配合使用,讲清一次出局是怎么发生的。
- 为选定球员收集用于梦幻板球研究的定性笔记,把它们当作解说文本,而不是官方的梦幻积分。
常见问题
获取球员解说需要哪些必填参数?
四个都需要:路径中的 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 参数的标准解说接口。