按赛事类型获取板球赛程,按日分组,支持 lastTime 翻页

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

返回某一类赛事分组的板球赛程。必填的路径参数 `type`(默认 `international`)可取 `international`、`league`、`domestic` 或 `women` 之一。可选的数字型查询参数 `lastTime` 是翻页游标:留空即加载第一页,传入毫秒级时间戳(例如 1640883600000)则加载下一页;参数说明指出应使用本接口返回的 `startDt` 字段作为取值参考。该接口没有记录过实时探测结果,响应说明来自一份未经验证、并被截断在 4000 个字符的来源示例。示例中响应体是一个对象,包含 `appIndex` 对象(`seoTitle`、`webURL`)和一个 `matchScheduleMap` 数组。数组条目要么是 `scheduleAdWrapper` 对象,要么是带有 `layout`、`name`、`position` 的 `adDetail` 广告对象。`scheduleAdWrapper` 包含 `date` 日期标签、`longDate` 字符串和 `matchScheduleList` 数组;其中每一项给出系列赛信息(`seriesId`、`seriesName`、`seriesCategory`,有时还有 `seriesHomeCountry`)以及一个 `matchInfo` 比赛数组。每场比赛包含 `matchId`、`seriesId`、`matchDesc`、`matchFormat`、`startDate` 和 `endDate`(类似时间戳的数字字符串)、`team1` 与 `team2` 对象(`teamId`、`teamName`、`teamSName`、`imageId`,有时有 `isFullMember`),以及 `venueInfo` 对象(`ground`、`city`、`country`、`timezone`)。示例中的开始时间字段叫 `startDate` 和 `endDate`,而不是 `startDt`,因此在依赖这些内容之前,请用真实响应确认应把哪个字段作为 lastTime 传入、每页数量,以及某个类型没有赛程时的返回结果。

API 功能

四类赛事分组 路径参数 type 支持 international、league、domestic 和 women,一个接口就能覆盖四类赛程列表。表单默认选中 international,并提供其余三个选项。
赛程按日分组 来源示例中每个 scheduleAdWrapper 都带有 date 日期标签和 longDate 值,当天的比赛嵌套在其中,可以直接对应到按天展示的赛程布局。
每个区块都带系列赛信息 每个 matchScheduleList 条目都用 seriesId、seriesName 和 seriesCategory 标明所属系列赛,因此无需再次查询,就能把一场比赛关联回它的赛事。
每场比赛的球队与场地 比赛条目列出 team1 和 team2 的 teamId、teamName、teamSName、imageId,以及包含 ground、city、country 和时区偏移字符串的 venueInfo,足够制作一张赛程卡片。
可衔接后续查询的比赛标识 每场比赛都带有 matchId 和 seriesId,用户点击某场比赛后,客户端可以带着它们去调用比赛详情、记分卡或系列赛相关接口。
用 lastTime 加载后续赛程 第一页让 lastTime 留空;要加载同一类型的下一页,请传入取自响应中某个开始时间字段的毫秒级时间戳。

在线 API 演示

GET /api/project/cricbuzz-cricket/matches-list-schedule

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

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/matches-list-schedule?key=<API_KEY>&type=international'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

赛程接口返回什么?

它返回所选类型的已安排比赛。由于没有记录过探测结果,数据结构来自一份被截断且未经验证的来源示例:一个 appIndex 对象和一个 matchScheduleMap 数组,数组中是按日划分的包装块,每块包含带 matchInfo 数组的系列赛区块,同时夹杂着广告占位条目。

type 可以传哪些值?

参数说明列出了四个值:international、league、domestic 和 women,表单默认是 international。其他取值不在文档范围内,使用前请先自行测试。

lastTime 翻页是怎么工作的?

第一页让 lastTime 留空。要加载下一页,请传入毫秒级时间戳,例如 1640883600000。说明里写的是使用本接口返回的 startDt 字段,但示例中出现的是 startDate 和 longDate,因此请用真实响应确认应该用哪个字段,以及该边界值是否包含在内。

为什么有些条目里没有比赛?

示例中混合了 scheduleAdWrapper 日期区块和只含 layout、name、position 的 adDetail 条目。请跳过没有 scheduleAdWrapper 键的条目。覆盖范围也取决于具体赛事,所以某个类型可能只返回很少的比赛,甚至没有比赛。

可以按日期、球队或系列赛筛选赛程吗?

该接口没有文档说明的此类筛选,输入只有 type 和 lastTime。请在收到列表后自行按 teamId、seriesId 或日期过滤,并且除 venueInfo 的 timezone 字符串所显示的信息外,不要自行假定时区。

相关接口

相关指南

查看订阅方案 →