用户指南
安卓用户指南已完成 v5.2 改版，案例合集导航收录 120+ 场馆信息，追比分步骤简化为两步。
追比分为什么现在只需两步？
v5.2 改版后，案例合集导航整合“订阅球队”入口，操作路径大幅缩短：
- 在案例合集导航中点击已订阅的球队卡片；
- 进入实时比分详情，比分、事件与进度同屏展示。
从进入页面到完成追比分只需两步，不再需要逐级跳转联赛列表。本次改版由技术团队 35 人分模块推进，覆盖 Android 5.0 至 Android 14 的系统适配。
改版后找不到原来的联赛入口？
首页顶部保留“联赛切换”按钮，按 24 个足球联赛分类展示。原有的一级入口已迁移至案例合集导航，支持分类筛选与关键词搜索，收藏的联赛会固定排在前面。
案例合集导航的订阅球队入口怎么用？
进入案例合集导航后，点击“订阅球队”，在列表中选择最多 12 支球队。订阅后，追比分入口自动出现在首页，两步即可完成。订阅数据与账号绑定，支持多设备同步。
积分榜战报
积分榜战报专栏覆盖 24 个足球联赛，数据延迟低于 500ms。赛后复盘、历史赛季与订阅视角均可在此完成。
积分榜数据多久更新一次？
比赛数据为秒级推送：比分变化、红黄牌、进球与替换事件在 500ms 内同步至前端与 API。每轮比赛结束后当天执行一次全量核对，覆盖排名、胜平负、净胜球与近期状态字段。
赛后复盘怎么查看？
- 进入积分榜战报专栏，将比赛状态筛选为“已结束”；
- 点击“赛后复盘”，查看进球时间轴、控球率、射门次数与球员评分。
复盘数据来源于公开信息与授权合作，支持按轮次、日期与球队三种方式筛选。更多赛事分析内容可前往专题观察查看。
积分榜支持哪些联赛和历史赛季？
平台覆盖 24 个足球联赛，数据辐射 200+ 国家与地区。支持查询任意已完成赛季的积分榜，字段包含胜平负、进球数、净胜球、主场战绩与客场战绩。下赛季数据会在赛季开始前 7 天自动开放。
我的积分榜视角为何与其他设备不同？
案例合集新增订阅球队入口后，你可以将关注球队置顶。积分榜视角与账号绑定，登录同一账号即可在任意设备同步。视角修改后约 10 秒内推送至其他登录设备。
API 集成
开发者服务已向 3000+ 注册开发者开放，接口文档提供中文与英文版本。接入时遇到错误码，先对照下方排查表。
API 接入需要几步完成？
- 注册开发者账号并完成邮箱验证；
- 在控制台创建应用，生成 API Key；
- 阅读中英文版开发者文档，确认接口版本；
- 调用
GET /api/v5/matches验证连接。
完整服务说明见开发者服务，支持 REST API、Webhook 与 SDK。
返回 401 Unauthorized 怎么排查？
检查请求头是否携带 Authorization: Bearer <API_KEY>，并确认 API Key 未过期。密钥可在控制台重新生成，新密钥生效后旧密钥在 5 分钟内失效。
返回 429 Too Many Requests 怎么办？
429 表示已达到当前订阅方案的调用限额。响应头会返回 x-ratelimit-remaining 与 x-ratelimit-reset 字段。免费开发者版每日提供 1000 次调用，控制台可随时升级配额方案。
Webhook 推送失败如何处理？
平台使用 HMAC-SHA256 签名，回调地址需返回 200 状态码。推送失败后自动重试 3 次，间隔分别为 10 秒、60 秒与 300 秒。持续失败时，控制台会将 Webhook 标记为“健康检查异常”。
账号与登录
忘记密码怎么办？
在登录页点击“忘记密码”，输入注册邮箱后，系统将在 5 分钟内发送重置链接。链接 24 小时内有效，同一账号每天最多发送 5 次重置邮件。
一个账号可以绑定几个邮箱？
主邮箱只能绑定一个。开发者账号可在“成员管理”中邀请团队成员，最多添加 5 个成员邮箱，每个成员拥有独立的 API Key 与操作权限。
如何在多台设备上保持积分榜同步？
登录同一账号后，订阅球队、案例合集筛选条件与积分榜视角自动同步。同步数据通过 TLS 1.3 加密传输，修改后约 10 秒内推送至其他设备。
注销账号后的数据如何处理？
通过联系我们提交注销申请，7 个工作日内完成账号注销。相关数据保留 30 天供申诉处理，之后全部删除且不可恢复。
联系支持
客服邮箱
kefu@tianbo-dev.com.cn
该邮箱为站点客服邮箱，用于提交问题工单、账号变更申请与商务合作联系，平均 2 小时内回复。
客服电话
400-1192-8978
24/7 客服热线，支持赛事数据查询、技术接入咨询与账号相关问题。
客服地址
山西省太原市小店区长风街131号
该地址用于数据备案与文档往来，不支持现场接待。
平台自 2017 年稳定运行，累计服务 3000+ 开发者。团队由技术 35 人、数据 15 人组成，持有 ISO 27001 认证，每月至少推出 2 次功能更新。最新动态可在专题观察中查阅。