跳至內容
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 金鑰收費
這頁有幫助嗎？
不太有
聯絡支援 →