按赛事类型获取板球赛程,按日分组,支持 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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'
查询结果
使用场景
- 搭建赛程页面,设置国际赛、联赛、国内赛和女子赛的标签页,每个标签页向同一个接口传入不同的 type 值。
- 同步本地赛程日历:保存每场返回比赛的 matchId、matchFormat 和开始时间字段,下次运行时对比,找出新增或变动的比赛。
- 为关注某支国家队的用户推送提醒:扫描 team1 和 team2 对象里的 teamId,并在列出的开赛日期之前发送通知。
- 制作出行或转播规划表,按 venueInfo 的国家和球场对即将进行的比赛分组,时区偏移字符串需先用真实数据核对后再使用。
- 为即将开赛的赛程原型化无限滚动:把最后一项的开始时间戳传给 lastTime,并记录下一页是否与上一页重叠或漏掉比赛。
常见问题
赛程接口返回什么?
它返回所选类型的已安排比赛。由于没有记录过探测结果,数据结构来自一份被截断且未经验证的来源示例:一个 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 字符串所显示的信息外,不要自行假定时区。