thscore-football-api

用途：为 AI 辅助开发提供 THScore 足球 API 的集成参考，覆盖身份验证、区域服务器选择及各足球端点。主要能力：提供 TypeScript 类型定义、端点桩、规则与完整代码示例；涉及客户端或 HTTP 封装搭建、实时比分与比赛时间线、联赛/杯赛参考数据、直播动画（iFrame/WebView）、积分榜与射手榜、FIFA 排名、亚盘/欧赔/1×2 赔率、历史数据同步、缓存与数据库模式设计、以及 API Key 错误与限流排查。使用方式：基础地址为 http://www.thscore.info/<API_PATH>?api_key=<YOUR_API_KEY>；亚洲服务器可用 http://api2.thscore.info/<API_PATH>?api_key=<YOUR_API_KEY>，API Key 应存入环境变量。直播动画通过 https://www.isportslive8.com/football/detail.html?matchId=...&accessKey=... 以 iFrame/WebView 嵌入，仅比赛处于进行中状态且 hasAnimation 为 true 时可用，APP 使用 WebView 无需白名单，网页 iFrame 需在控制台登记域名白名单。限制：各端点有硬性调用频率与推荐频率（如实况 10 秒/次、推荐 1 分钟/次；赛程 60 秒/次；联赛资料 1 小时或 30 分钟/次），不应在 HTTP 请求处理器内轮询，建议后台任务写入缓存；付费方案与价格在资料中列出（如 Live Data $599/月、Stats $399/月、Live Animation $1699/月等），但完整端点集与部分方案能力细节暂未提供。