跳至内容
Tipsme

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

实际响应 ·

{
  "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 的栏位;使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段类型说明
tierstring方案级别名称。
dailyQuotainteger每个账户每个香港历日的方案请求数目。
ratePerMinuteinteger每条 API 密钥每分钟的请求上限,方案及免费赛程请求均受限制。
maxKeysinteger每个账户限一条未撤销 API 密钥;已过期密钥仍占名额,须先撤销。
maxAllowlistEntriesPerKeyinteger每条金钥可设定的 IP 允许清单项目数。
freeMatchesDailyQuotainteger此方案每个账户每日(香港时间)的免费赛程额度(GET /v1/football/matches),会先于方案额度使用。
featuresTierFeaturesDto可能省略此方案实际享有的功能权限。
└analysisboolean此方案是否可以调用分析接口。

返回状态 200

前往试用

套餐及价格

GET/v1/football/meta/plans

请求示例

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

响应示例 200 · application/json

实际响应 ·

{
  "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 的栏位;使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。

字段类型说明
currencystring所有价格的 ISO 货币代码。
tiersPricingTierDto[]每个方案级别一笔资料,Free 排第一。
└tierstring方案级别名称。
└limitsTierLimitsDto该方案的使用限制。
└tierstring方案级别名称。
└dailyQuotainteger每个账户每个香港历日的方案请求数目。
└ratePerMinuteinteger每条 API 密钥每分钟的请求上限,方案及免费赛程请求均受限制。
└maxKeysinteger每个账户限一条未撤销 API 密钥;已过期密钥仍占名额,须先撤销。
└maxAllowlistEntriesPerKeyinteger每条金钥可设定的 IP 允许清单项目数。
└freeMatchesDailyQuotainteger此方案每个账户每日(香港时间)的免费赛程额度(GET /v1/football/matches),会先于方案额度使用。
└featuresTierFeaturesDto可能省略此方案实际享有的功能权限。
└analysisboolean此方案是否可以调用分析接口。
└monthlyApiPlanDto可能省略月费方案;Free 会省略。
└idinteger方案版本的识别码。
└planCodestring固定方案代码,例如 TipsmeApiPlusM。
└tierstringFree、Plus 或 Pro。
└billingPeriodstringmonthly(每月)或 yearly(每年)。
└monthsinteger每个收费周期的月数。
└pricenumber每个收费周期的价格。
└currencystringISO 货币代码,例如 HKD(港元)。
└versioninteger方案版本;价格更新时会有新版本。
└compareAtPricenumber可能省略优惠期间用作比较的原价。
└discountPercentnumber可能省略相对原价的折扣百分比。
└yearlyApiPlanDto可能省略年费方案;Free 会省略。
└idinteger方案版本的识别码。
└planCodestring固定方案代码,例如 TipsmeApiPlusM。
└tierstringFree、Plus 或 Pro。
└billingPeriodstringmonthly(每月)或 yearly(每年)。
└monthsinteger每个收费周期的月数。
└pricenumber每个收费周期的价格。
└currencystringISO 货币代码,例如 HKD(港元)。
└versioninteger方案版本;价格更新时会有新版本。
└compareAtPricenumber可能省略优惠期间用作比较的原价。
└discountPercentnumber可能省略相对原价的折扣百分比。
└yearlySavingPercentnumber可能省略年费相对于十二次月费的节省金额。
└yearlyMonthlyEquivalentnumber可能省略年费除以十二的每月平均价格。
propagationSecondsinteger方案变更生效所需时间。
recommendedTierstring可能省略价格页重点显示的方案。
freeMatchesDailyQuotainteger可能省略Free 方案的赛程列表额度。此字段已弃用;请改用 tiers[].limits.freeMatchesDailyQuota 取得各方案额度。为兼容旧有客户端而保留。

返回状态 200

前往试用

由免费方案开始

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

这页有帮助吗?联系支持 →