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 的栏位;使用前请先检查栏位是否存在。栏位名称在所有语言中均相同。
| 字段 | 类型 | 说明 |
|---|---|---|
| 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
实际响应 ·
{
"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 次免费赛程列表请求。真实数据,无需信用卡。