跳至内容
Tipsme

赛程

按日期、联赛及状态筛选比赛列表，附球队标志及已提供的实时比分。

本页内容

赛程

GET/v1/football/matches

参数

  • datestring (date)query选填

    以 YYYY-MM-DD 格式输入日期，并按 tz 解释。留空表示包含现有赛程中的所有日期。

  • leaguestringquery选填

    使用赛事 competition.name 或 nameOriginal 中的完整名称，不区分大小写。留空表示全部赛事。 例如： Premier League 在 API 参考查找此值

  • statusstringquery选填

    按未开赛、进行中、已完场、延期或取消筛选。留空表示所有状态。 例如： live

  • pageinteger,string (int32)query选填

    页码从 1 开始。留空或小于 1 的数值会使用第 1 页。 例如： 1

  • pageSizeinteger,string (int32)query选填

    每页项目数。默认 25，最多 100；超过 100 的数值会由 API 限制为 100。 例如： 25

  • tzinteger,string (int32)query选填

    日期筛选使用的 UTC 时差，以分钟计：480 为香港（UTC+8），0 为 UTC。响应中的开赛时间仍使用 UTC。 例如： 480

请求示例

curl -H "Authorization: Bearer $TIPSME_API_KEY" \
  "https://api.tipsme.hk/v1/football/matches"

data 中每个项目包含 · 34

选填栏位可能不会出现。API 会省略值为 null 的栏位；使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段类型说明
idintegerTipsme 比赛识别码，可用于所有 /matches/{matchId}/… 端点。
kickoffUtcdatetime预定开赛时间，采用 ISO-8601 UTC。
competitionCompetitionRef赛事名称。
└namestring可能省略所请求语言的赛事名称。
└nameOriginalstring可能省略来源公布的赛事名称。
homeTeamRef主队。
└namestring可能省略Accept-Language 指定语言的球队名称；无翻译时使用原名。
└nameOriginalstring可能省略资料来源公布的球队名称。
└rankingstring可能省略开赛时的联赛排名（如已知）。
awayTeamRef客队。
└namestring可能省略Accept-Language 指定语言的球队名称；无翻译时使用原名。
└nameOriginalstring可能省略资料来源公布的球队名称。
└rankingstring可能省略开赛时的联赛排名（如已知）。
statusintegerscheduled（未开赛）、live（进行中）、finished（完场）、postponed（延期）或 cancelled（取消）；代码不随语言改变。
minutestring可能省略即时比赛分钟，例如 63 或 45+2。
additionalTimestring可能省略本半场公布的补时分钟数。
scoreScoreDto可能省略各阶段比分；开赛前未有资料时会省略。
└currentstring可能省略目前或完场比分，格式为「主队-客队」。
└halfTimestring可能省略半场比分。
└extraTimestring可能省略加时赛后的比分（如有加时）。
└penaltystring可能省略互射十二码比分（如有进行）。
homeCardsCardCount可能省略主队获出示的牌数。
└yellowinteger可能省略此方获出示的黄牌数。
└redinteger可能省略此方获出示的红牌数。
awayCardsCardCount可能省略客队获出示的牌数。
└yellowinteger可能省略此方获出示的黄牌数。
└redinteger可能省略此方获出示的红牌数。
cornersstring可能省略角球数，格式为「主队-客队」。
isNeutralVenuebooleantrue 表示在中立场地作赛。
isCupbooleantrue 表示杯赛。
isBracketbooleantrue 表示此赛程属于淘汰赛。
isHkjcbooleantrue 表示香港赛马会提供此赛事；只有此类比赛可能提供马会赔率。
homeLogostring可能省略由主队原始名称组成的 assets.tipsme.hk PNG 队徽网址。原始名称缺失时省略；图片可能不存在。
awayLogostring可能省略由客队原始名称组成的 assets.tipsme.hk PNG 队徽网址。原始名称缺失时省略；图片可能不存在。

返回状态 200, 401, 403, 429, 502, 503

前往试用

由免费方案开始

一个 API 密钥，每个账户每日 30 次请求，另加每日 50 次免费赛程列表请求。真实数据，无需信用卡。

获取免费 API 密钥价格
这页有帮助吗？
不太有
联系支持 →