API 資訊

免費、Plus 和 Pro 的公開方案價格、請求上限及分析權限。

本頁內容

方案限額

GET/v1/football/meta/limits

請求範例

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

回應範例 200 · application/json

實際回應 · 擷取於 2026年9月30日上午10:18（香港時間）

{
  "data": [
    {
      "tier": "Free",
      "dailyQuota": 30,
      "ratePerMinute": 30,
      "maxKeys": 1,
      "maxAllowlistEntriesPerKey": 3,
      "freeMatchesDailyQuota": 50,
      "features": {
        "analysis": false
      }
    },
    {
      "tier": "Plus",
      "dailyQuota": 5000,
      "ratePerMinute": 120,
      "maxKeys": 1,
      "maxAllowlistEntriesPerKey": 3,
      "freeMatchesDailyQuota": 500,
      "features": {
        "analysis": true
      }
    },
    {
      "tier": "Pro",
      "dailyQuota": 30000,
      "ratePerMinute": 600,
      "maxKeys": 1,
      "maxAllowlistEntriesPerKey": 3,
      "freeMatchesDailyQuota": 2000,
      "features": {
        "analysis": true
      }
    }
  ]
}

data 中每個項目包含 · 8

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
tier	string	方案級別名稱。
dailyQuota	integer	每個帳戶每個香港曆日的方案請求數目。
ratePerMinute	integer	每條 API 金鑰每分鐘的請求上限，方案及免費賽程請求均受限制。
maxKeys	integer	每個帳戶限一條未撤銷 API 金鑰；已過期金鑰仍佔名額，須先撤銷。
maxAllowlistEntriesPerKey	integer	每條金鑰可設定的 IP 允許清單項目數。
freeMatchesDailyQuota	integer	此方案每個帳戶每日（香港時間）的免費賽程額度（GET /v1/football/matches），會先於方案額度使用。
features	TierFeaturesDto可能省略	此方案實際享有的功能權限。
└analysis	boolean	此方案是否可以呼叫分析接口。

回應狀態 200

前往試用

方案及價格

GET/v1/football/meta/plans

請求範例

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

回應範例 200 · application/json

實際回應 · 擷取於 2026年9月30日上午10:18（香港時間）

{
  "data": {
    "currency": "HKD",
    "tiers": [
      {
        "tier": "Free",
        "limits": {
          "tier": "Free",
          "dailyQuota": 30,
          "ratePerMinute": 30,
          "maxKeys": 1,
          "maxAllowlistEntriesPerKey": 3,
          "freeMatchesDailyQuota": 50,
          "features": {
            "analysis": false
          }
        }
      },
      {
        "tier": "Plus",
        "limits": {
          "tier": "Plus",
          "dailyQuota": 5000,
          "ratePerMinute": 120,
          "maxKeys": 1,
          "maxAllowlistEntriesPerKey": 3,
          "freeMatchesDailyQuota": 500,
          "features": {
            "analysis": true
          }
        },
        "monthly": {
          "id": 7,
          "planCode": "TipsmeApiPlusM",
          "tier": "Plus",
          "billingPeriod": "monthly",
          "months": 1,
          "price": 188,
          "currency": "HKD",
          "version": 2
        },
        "yearly": {
          "id": 8,
          "planCode": "TipsmeApiPlusY",
          "tier": "Plus",
          "billingPeriod": "yearly",
          "months": 12,
          "price": 1880,
          "currency": "HKD",
          "version": 2
        },
        "yearlySavingPercent": 17,
        "yearlyMonthlyEquivalent": 156.67
      },
      {
        "tier": "Pro",
        "limits": {
          "tier": "Pro",
          "dailyQuota": 30000,
          "ratePerMinute": 600,
          "maxKeys": 1,
          "maxAllowlistEntriesPerKey": 3,
          "freeMatchesDailyQuota": 2000,
          "features": {
            "analysis": true
          }
        },
        "monthly": {
          "id": 9,
          "planCode": "TipsmeApiProM",
          "tier": "Pro",
          "billingPeriod": "monthly",
          "months": 1,
          "price": 688,
          "currency": "HKD",
          "version": 2
        },
        "yearly": {
          "id": 10,
          "planCode": "TipsmeApiProY",
          "tier": "Pro",
          "billingPeriod": "yearly",
          "months": 12,
          "price": 6880,
          "currency": "HKD",
          "version": 2
        },
        "yearlySavingPercent": 17,
        "yearlyMonthlyEquivalent": 573.33
      }
    ],
    "propagationSeconds": 60,
    "recommendedTier": "Plus",
    "freeMatchesDailyQuota": 50
  }
}

回應欄位 · 39

選填欄位可能不會出現。API 會省略值為 null 的欄位；使用前請先檢查欄位是否存在。欄位名稱在所有語言中均相同。

欄位	類型	說明
currency	string	所有價格的 ISO 貨幣代碼。
tiers	PricingTierDto[]	每個方案級別一筆資料，Free 排第一。
└tier	string	方案級別名稱。
└limits	TierLimitsDto	該方案的使用限制。
└tier	string	方案級別名稱。
└dailyQuota	integer	每個帳戶每個香港曆日的方案請求數目。
└ratePerMinute	integer	每條 API 金鑰每分鐘的請求上限，方案及免費賽程請求均受限制。
└maxKeys	integer	每個帳戶限一條未撤銷 API 金鑰；已過期金鑰仍佔名額，須先撤銷。
└maxAllowlistEntriesPerKey	integer	每條金鑰可設定的 IP 允許清單項目數。
└freeMatchesDailyQuota	integer	此方案每個帳戶每日（香港時間）的免費賽程額度（GET /v1/football/matches），會先於方案額度使用。
└features	TierFeaturesDto可能省略	此方案實際享有的功能權限。
└analysis	boolean	此方案是否可以呼叫分析接口。
└monthly	ApiPlanDto可能省略	月費方案；Free 會省略。
└id	integer	方案版本的識別碼。
└planCode	string	固定方案代碼，例如 TipsmeApiPlusM。
└tier	string	Free、Plus 或 Pro。
└billingPeriod	string	monthly（每月）或 yearly（每年）。
└months	integer	每個收費週期的月數。
└price	number	每個收費週期的價格。
└currency	string	ISO 貨幣代碼，例如 HKD（港元）。
└version	integer	方案版本；價格更新時會有新版本。
└compareAtPrice	number可能省略	優惠期間用作比較的原價。
└discountPercent	number可能省略	相對原價的折扣百分比。
└yearly	ApiPlanDto可能省略	年費方案；Free 會省略。
└id	integer	方案版本的識別碼。
└planCode	string	固定方案代碼，例如 TipsmeApiPlusM。
└tier	string	Free、Plus 或 Pro。
└billingPeriod	string	monthly（每月）或 yearly（每年）。
└months	integer	每個收費週期的月數。
└price	number	每個收費週期的價格。
└currency	string	ISO 貨幣代碼，例如 HKD（港元）。
└version	integer	方案版本；價格更新時會有新版本。
└compareAtPrice	number可能省略	優惠期間用作比較的原價。
└discountPercent	number可能省略	相對原價的折扣百分比。
└yearlySavingPercent	number可能省略	年費相對於十二次月費的節省金額。
└yearlyMonthlyEquivalent	number可能省略	年費除以十二的每月平均價格。
propagationSeconds	integer	方案變更生效所需時間。
recommendedTier	string可能省略	價格頁重點顯示的方案。
freeMatchesDailyQuota	integer可能省略	Free 方案的賽程列表額度。不建議再使用此欄位；請改用 tiers[].limits.freeMatchesDailyQuota 取得各方案額度。為相容舊有客戶端而保留。

回應狀態 200

前往試用

由免費方案開始

一條 API 金鑰，每個帳戶每日 30 次請求，另加每日 50 次免費賽程列表請求。真實數據，毋須信用卡。

取得免費 API 金鑰收費

這頁有幫助嗎？

不太有

聯絡支援 →