服务概览
六项核心能力构成完整服务矩阵，数据、组件、工具与支持统一在控制台协作。
赛事数据 API
REST 接口 + JSON 响应，覆盖 24 个足球联赛的比分、积分榜、球队与赛程数据。
进入模块 02移动端 SDK
Android 8.0+ 与 iOS 14+ 双端支持，内置积分榜渲染器、数据缓存与订阅管理。
进入模块 03案例合集导航
120+ 场馆信息、分类筛选与订阅球队入口，追比分从进入页面到完成只需两步。
进入模块 04开发者工具
API 控制台、请求调试器、30 天审计日志，以及 JavaScript、Python、Java 示例代码。
进入模块 05订阅方案
从免费开发者版到企业级弹性配额，每月至少推出 2 次功能更新，可按需升级。
进入模块 06支持中心
安卓用户指南 v5.2、API 接入文档、常见问题与 24/7 客服热线，全程协助接入。
进入支持赛事数据 API
标准 REST 协议输出比赛、积分榜、球队与赛程数据，统一 JSON 响应格式，支持按联赛、日期、球队等维度查询。数据源来自公开信息与授权合作。
实时赛事数据
覆盖 24 个足球联赛的比分、红黄牌、替换与事件流，状态切换延迟低于 500ms。
积分榜与赛程
按轮次返回完整积分榜，字段包含排名、胜平负、净胜球与近期状态，支持任意赛季查询。
球队与场馆档案
球队基本信息、场馆容量、位置坐标与交通索引，与案例合集导航数据同源。
认证与限流
API Key 认证，支持 Bearer Token 请求头或查询参数；阶梯限流策略在响应头中明确标注余量。
Webhook 推送
比分、赛程、积分榜变更即时推送，支持自定义密钥签名与自动重试策略。
# GET /api/v5/matches
GET /api/v5/matches?league=premier-league
Authorization: Bearer <YOUR_API_KEY>
# 200 OK — JSON 响应
{
"matches": [
{
"id": "m_48291",
"home": "Arsenal",
"away": "Chelsea",
"status": "live",
"home_score": 2,
"away_score": 1
}
]
}
移动端 SDK
支持 Android 8.0+ 为 iOS 14+，内置积分榜渲染器、数据缓存与订阅球队管理。安卓用户指南已完成 v5.2 改版，集成路径更短、操作更直观。
-
01
添加依赖
通过 Gradle 或 CocoaPods 安装，SDK 体积约 1.2MB，无额外强制依赖。
-
02
初始化客户端
使用 API Key 创建 TBRaceClient 实例，自动配置连接池、超时与重试策略。
-
03
拉取数据
调用
standings()与matches()方法，支持本地缓存与增量更新。 -
04
渲染组件
内置积分榜 UI 以深浅双主题呈现，可直接嵌入 RecyclerView 或 SwiftUI 列表。
v5.2 改版要点
- 追比分步骤简化为两步：进入比赛页 → 点击「追比分」
- 案例合集导航新增订阅球队入口
- 数据缓存策略升级，弱网下积分榜仍可秒开
案例合集导航
案例合集导航收录 120+ 场馆信息与赛事实例，支持按联赛、城市、容量组合筛选。订阅球队入口已同步至首页与比赛详情页，比分跟踪更高效。
示例场馆 · 华东主场馆
座位分区与交通索引
容纳 18,500 人，含 VIP 包厢 120 间，周边地铁线路 3 条，停车场车位 820 个。案例档案中已包含该场馆的总览图与逐层座位数据。
分类筛选
按联赛、城市、场馆容量三个维度组合筛选，结果列表实时刷新，并显示每个场馆的可订阅状态。
订阅球队入口
关注球队后，积分榜排名、近期赛程与比分变化自动进入个人中心，支持推送提醒。
两步追比分
STEP 1 打开比赛详情页
STEP 2 点击「追比分」
开发者工具
统一控制台内完成 API 调试、请求审计与数据监控，并提供 JavaScript、Python、Java 三种语言的调用示例，降低接入门槛。
API 控制台
在线发起请求，实时查看响应头与 JSON 数据体，错误状态码自动标注并给出排查建议。
请求调试器
支持请求重放、参数修改与响应对比，便于快速定位不同查询条件下的数据差异。
审计日志
保留 30 天完整请求记录，包含调用方地址、时间戳、耗时、状态码与限流触发情况。
多语言示例
JavaScript、Python、Java 三种语言的基础调用片段已内置，可直接复制到工程中运行。
订阅方案
从免费起步到企业级弹性配额，价格透明，支持按月订阅与随时升级。开发者版可体验全部核心功能，适用于个人项目与学习场景。
| 功能 | 开发者版 | 专业版 | 企业版 |
|---|---|---|---|
| 月费 | ¥0 | ¥499 | ¥2,999 |
| API 每日请求量 | 500 次 | 50,000 次 | 不限次数 |
| 联赛覆盖 | 1 个 | 8 个 | 全部 24 个 |
| Webhook 每日推送 | 50 次 | 5,000 次 | 不限次数 |
| 文档与示例代码 | ✓ | ✓ | ✓ |
| 支持渠道 | 社区文档 | 邮件工单 | 7×24 小时专属通道 |
| 私有化部署 | — | — | ✓ |
