# THScore Football API – 开发者技能使用 [THScore Football API]() 的综合最佳实践和参考指南。该技能提供 TypeScript 类型定义、端点存根、规则和完整的代码示例，旨在使 AI 代理辅助集成可靠且可投入生产。 ** ** ## 何时申请在以下情况下参考此技能： * 设置 THScore API 客户端或 HTTP 包装器 * 获取**实时比分**、比赛时间线或比赛中统计数据 * 检索**联赛/杯赛参考数据**（国家、联赛 ID、规则） * 显示**直播足球动画**（iFrame/WebView 嵌入） * 建立**积分榜**、最佳射手榜或 FIFA 排名页面 * 整合**亚洲让分盘、欧洲盘口或 1×2 赔率** feed * 构建预定作业以同步**历史比赛数据** * 为运动数据设计缓存层或数据库模式 * 调试 API 密钥错误、速率限制违规或格式错误的响应 ** ** ## 可用的产品计划和端点集计划| # API |主要特点 ---|---|--- **实时数据**（599 美元/月）| 22 | 22实时比分、赛程表、赛事、阵容、实时文本、个人资料 **统计**（$399/月）| 13 |比赛分析、球员统计、积分榜、最佳射手、FIFA 排名 **赔率** | — | 18 博彩公司，亚洲让分盘，欧洲盘，1×2 **赔率专业版** | — | 200+ 欧洲博彩公司 **必发** | — | Betfair 交换数据 **实时动画**（1699 美元/月）| 1 | iFrame/WebView 动画，42 个事件 **历史数据库** | — |过往赛季、历史比赛数据 **通用API** |无穷大|由所有付费计划共享：联赛和杯赛概况、国家/地区、博彩公司 ** ** ## 基本 URL 和身份验证 http://www.thscore.info/?api_key= 对于**位于亚洲的服务器**（较低延迟）： http://api2.thscore.info/?api_key= > 始终将 `api_key` 存储在环境变量中，切勿对其进行硬编码。 ** ** ## TypeScript 类型 (`types.ts`) // ============================================================== // 类型.ts // THScore Football API – 完整的 TypeScript 类型定义 // ============================================================== // ── 共同/共享 ────────────────────────────────────── /** Unix 时间戳（秒） */ 输入 UnixTimestamp = 数字； /** ISO 3166-1 alpha-2 国家代码 */ 输入国家/地区代码 = 字符串； /** 由 Livescores 返回的匹配状态整数 */ 导出枚举 MatchState { 未开始 = 0, 上半场 = 1, 半场时间 = 2, 下半场 = 3, 加时赛第一 = 4, 加时HT = 5, 额外时间秒 = 6, 点球大战 = 7, 完成=-1，推迟=-11，取消=-12，待定=-13，被遗弃=-14，暂停=-15，延迟=-16，中断=-17，加时赛 = -18, 越过=-19， } /** 匹配状态标签（用于显示给最终用户） */ 导出 const MatchStateLabel: Record = { [MatchState.NotStarted]: "未开始", [MatchState.FirstHalf]: "上半场", [MatchState.HalfTime]: "半场", [MatchState.SecondHalf]: "下半场", [MatchState.ExtraTimeFirst]: "加时赛第一轮", [MatchState.ExtraTimeHT]: "加时赛HT", [MatchState.ExtraTimeSecond]: "加时赛第二场", [MatchState.PenaltyShootout]: "点球", [MatchState.Finished]: "完成", [MatchState.Postponed]: "已推迟", [MatchState.Cancelled]: "已取消", [比赛状态.TBD]：“待定”， [MatchState.Abandoned]: "已放弃", [MatchState.Suspished]：“已暂停”， [MatchState.Delayed]: "延迟", [MatchState.Interrupted]：“已中断”， [MatchState.ExtraTime]: "加时赛", [MatchState.Walkover]: "Walkover", }; // ── 通用API ────────────────────────────────────────────── // GET /football_th/league/basic.aspx（限制 1 小时/建议 1 天）导出接口 LeagueBasic { leagueId：号码；联赛名称：字符串； leagueNameEn: 字符串; 国家ID：号码；国家名称：字符串；国家名称En: 字符串; leagueLogo：字符串； // 网址国家标志：字符串； // 网址类型：数字； // 1 = 联赛，2 = 杯赛，3 = 国际比赛 curSeasonId：数字； } 导出接口 LeagueBasicResponse { 代码：号码；消息：字符串；结果：LeagueBasic[]； } // GET /football_th/league.aspx（限制 30 分钟/建议 1 天）导出接口 LeagueFull 扩展 LeagueBasic { seasonId：数字；季节名称：字符串；开始日期：字符串； //“年-月-日” 结束日期：字符串； //“年-月-日” 主要颜色：字符串； // 十六进制 secondaryColor：字符串； // 十六进制官方网站：字符串； // 网址球队总数：数量； } // 获取 /football_th/league.aspx?cmd=rule // 返回联赛规则（循环赛制、阶段等）导出接口 LeagueRule { leagueId：号码； seasonId：数字；信息：字符串； // HTML 或纯文本规则 } // ── 实时数据计划 ────────────────────────────────────────── // GET /football_th/livescores.aspx（限制 10 秒/建议 1 分钟）导出接口LiveMatch { matchId：号码； leagueId：号码；联赛名称：字符串；主队ID：号码；主队名称：字符串； awayTeamId：号码；离开球队名称：字符串；主场得分：数字；客场得分：数字； homeHalfScore：数量； awayHalfScore：数字；状态：匹配状态； matchTime：Unix时间戳； // UTC 开始时间已过去：数量； // 已过去的分钟数（如果未开始则为 0 分钟） homeRed：数字；远红：数字；主页黄色：号码；离开黄色：数量； homeCorner：号码；远角：数量；圆形：字符串；有动画：布尔值； // 如果实时动画可用则为 true 动画匹配Id？：数字； // 在动画 iFrame URL 中使用 } 导出接口 LivescoresResponse { 代码：号码；消息：字符串；结果：LiveMatch[]； } // GET /football_th/schedule/results.aspx（限制 60 秒/建议 6 小时）导出接口 ScheduledMatch { matchId：号码； leagueId：号码；联赛名称：字符串；主队ID：号码；主队名称：字符串； awayTeamId：号码；离开球队名称：字符串；主页得分：数字 |无效的; // null = 未来的匹配客场得分：数量 |无效的; 状态：匹配状态； matchTime：Unix时间戳；圆形：字符串； } // GET /football_th/matchevent.aspx（60 秒限制） // 事件包括：进球、黄牌、换人导出枚举事件类型{ 目标 = 1，乌龙球 = 2, 黄牌 = 3, 红牌 = 4, 黄红 = 5, 替换 = 6, 处罚 = 7, 错失罚球 = 8, } 导出接口 MatchEvent { matchId：号码；类型：事件类型；分钟：数字；添加时间：数量； // 补时分钟团队ID：号码；玩家ID：号码；玩家名称：字符串； relatedPlayerId?: 数字； // 例如被替换下场的球员相关玩家名称？：字符串； } // 获取 /football_th/matchlineup.aspx 导出接口播放器{ 玩家ID：号码；玩家名称：字符串；衬衫号码：号码；位置：字符串； //“GK”| “DF”| “MF”| “固件” 正在开始：布尔值；是队长：布尔值；国家代码：国家代码； } 导出接口 MatchLineup { matchId：号码；主队ID：号码； awayTeamId：号码；主队阵容：球员[]；客场阵容：球员[]；主替补：球员[]；客场替补：球员[]； homeFormation：字符串； // 例如“4-3-3” awayFormation：字符串； homeCoach：字符串；离开教练：字符串； } // ── 配置文件（实时数据计划）──────────────────────────────── // GET /football_th/league.aspx → LeagueFull（见上文） // 获取 /football_th/team.aspx 导出接口团队{ 团队ID：号码；团队名称：字符串； teamNameEn: 字符串; 团队标志：字符串； // 网址国家ID：号码；国家名称：字符串；体育场：字符串；容量：数量；成立：数量； // 年网站：字符串； } // 获取 /football_th/player.aspx 导出接口PlayerProfile { 玩家ID：号码；玩家名称：字符串；玩家名称En: 字符串; 照片：字符串； // 网址国籍：国家代码；位置：字符串；出生日期：字符串； //“年-月-日” 高度：数字； // 厘米重量：数量； // 公斤当前TeamId：号码； } // ── 统计计划────────────────────────────────────────────── // 获取 /football_th/league/table.aspx （文档：/doc/docs_id=43）导出接口 StandingRow { 排名：数量；团队ID：号码；团队名称：字符串；玩过：号码；赢得: 数量; 抽取：数量；丢失：数量；目标：数量；目标：数量；目标差异：数量；点：数量；形式：字符串[]； // 最后 5 个结果: "W" | “D”| “L” 胜率：数字； // 百分比 0–100 绘制率：数字；损失率：数字； } 导出接口StandingsResponse { 代码：号码； leagueId：号码； seasonId：数字；结果：StandingRow[]； } // 获取 /football_th/topscorer.aspx （文档：/doc/docs_id=39）导出接口 TopScorer { 排名：数量；玩家ID：号码；玩家名称：字符串；团队ID：号码；团队名称：字符串；目标：数量； fieldGoals：数量；处罚：数量；助攻：数量；出场次数：数量； } // 获取 /football_th/fifaranking.aspx （文档：/doc/docs_id=47）导出接口 FifaRankingEntry { 排名：数量；以前的排名：数量；团队ID：号码；团队名称：字符串；国家代码：国家代码；点：数量； previousPoints: 数量；等级变化：数量； // 正值=向上，负值=向下 } // ── 赔率 ──────────────────────────────────────────────────── 导出接口 AsianHandicapOdds { matchId：号码；庄家：字符串；家：号码； // 主队赔率障碍：数量； // 例如-0.5 离开：数量；更新时间：UnixTimestamp； } 导出接口EuropeanOdds { matchId：号码；庄家：字符串；家：号码；抽签：数字；离开：数量；更新时间：UnixTimestamp； } // ── 实时动画 ────────────────────────────────────────── //（无 API 响应类型 — 它是 iFrame/WebView URL）导出接口AnimationEmbedParams { matchId：号码；访问密钥：字符串； } 导出函数 buildAnimationUrl(params: AnimationEmbedParams): string { 返回 `https://www.isportslive8.com/football/detail.html?matchId=${params.matchId}&accessKey=${params.accessKey}`; } ** ** ## 按优先级规则类别优先|类别 |前缀 |影响 ---|---|---|--- 1 |身份验证和路由| `auth-` |关键 2 |速率限制和缓存| `限制-` |关键 3 |实时动画 – 时间和方式 | `动画-` |高 4 |特定于端点的最佳实践| `ep-` |高 5 |错误处理和弹性| `错误-` |高 6 |数据标准化和类型 | `数据-` |中 7 |安全| `安全-` |关键 ** ** ## 规则 ### 1\.身份验证和路由（关键） #### `auth-env-key` – 将 API 密钥存储在环境变量中 ❌ **错误：** const url = `http://www.thscore.info/football_th/livescores.aspx?api_key=abc123`; ✅ **正确：** const API_KEY = process.env.THSCORE_API_KEY; if (!API_KEY) throw new Error("THSCORE_API_KEY 未设置"); const url = `http://www.thscore.info/football_th/livescores.aspx?api_key=${API_KEY}`; #### `auth-asia-server` – 对位于亚洲的服务器使用 `api2.thscore.info` // 配置.ts 导出常量 THSCORE_HOST = process.env.THSCORE_REGION === "亚洲" ？ “api2.thscore.info” ：“www.thscore.info”；导出函数 buildUrl(path: string, params: Record = {}): string { const base = `http://${THSCORE_HOST}${path}`; const 查询 = 新 URLSearchParams({ api_key: process.env.THSCORE_API_KEY!, ...参数， }); 返回 `${base}?${query.toString()}`; } ** ** ### 2\.速率限制和缓存（关键）端点|硬限制|推荐 ---|---|--- “今日比分”| 10 秒/通话 | 1 分钟/通话 `日程和结果` | 60 秒/次 | 6 小时/通话 `联赛和杯赛简介（基本）` | 1 小时/通话 | 1 天/通话 `联赛和杯赛简介（完整）` | 30 分钟/通话 | 1 天/通话 `排名` | — | 1 小时/通话 “最佳射手”| — | 1 天/通话《国际足联排名》| — | 1周/通话 #### `limit-tiered-cache` – 每个端点类型使用适当的 TTL //cache.service.ts（使用Redis）从“ioredis”导入{Redis}； const redis = new Redis(process.env.REDIS_URL!); 异步函数cachedFetch(key: string, ttlSeconds: number, fetcher: () => Promise): Promise { const 缓存 = 等待 redis.get(key); if (cached) 返回 JSON.parse(cached) as T; const 数据 = 等待 fetcher(); 等待 redis.setex(key, ttlSeconds, JSON.stringify(data)); 返回数据； } // 用法示例： // 实时比分 — 缓存 60 秒 const livescores =等待cachedFetch("thscore:livescores", 60, fetchLivescores); // 联赛列表——缓存24小时 const leagues =等待cachedFetch("thscore:leagues", 86400, fetchLeagues); // 排行榜 — 缓存 1 小时 const 排名=等待cachedFetch(`thscore:排名:${leagueId}`, 3600, () => fetchStandings(leagueId)); #### `limit-background-sync` – 切勿在 HTTP 请求处理程序中轮询 API // 不好：在路由处理程序内轮询 app.get("/api/livescores", async (req, res) => { const data = wait fetch(buildUrl("/football_th/livescores.aspx")); // ← 阻止用户 res.json(等待 data.json()); }); // 好：路由处理程序从缓存中读取；一个 cron 作业填充它 app.get("/api/livescores", async (req, res) => { const cached = wait redis.get("thscore:livescores"); res.json(cached ? JSON.parse(cached) : { code: 503, message: "数据尚未准备好" }); }); // cron 作业（每 60 秒） cron.schedule("* * * * *", async () => { const data = 等待 fetchLivescores(); 等待 redis.setex("thscore:livescores", 90, JSON.stringify(data)); }); ** ** ### 3\.实时动画 – 时间和方式（高） #### `anim-when` – 当实时动画数据可用时实时动画仅在以下活动状态之一的**实时比赛**期间可用：从“./types”导入{MatchState}； const ANIMATION_STATES: MatchState[] = [ 比赛状态.FirstHalf, MatchState.HalfTime, MatchState.SecondHalf, MatchState.ExtraTimeFirst， MatchState.ExtraTimeHT, MatchState.ExtraTimeSecond, MatchState.点球大战， ]; 导出函数 isAnimationAvailable(match: LiveMatch): boolean { 返回 ANIMATION_STATES.includes(match.state) && match.hasAnimation === true; } > 检查 Livescores 响应中的 `hasAnimation: true`。不要为预定/已完成的比赛嵌入 iFrame – 动画 URL 将返回空白页面。 #### `anim-embed-html` – 将动画嵌入页面中（PC/H5 通过 iFrame） // 匹配详细信息.ts 从“./types”导入{ buildAnimationUrl, isAnimationAvailable, LiveMatch }；函数 renderAnimation(match: LiveMatch): void { const container = document.getElementById("animation-container")!; const iframe = document.getElementById("match-animation") as HTMLIFrameElement; if (!isAnimationAvailable(match)) { 容器.style.display = "无"; 返回; } const url = buildAnimationUrl({ matchId: match.animationMatchId ??匹配.matchId, accessKey: process.env.THSCORE_ANIMATION_ACCESS_KEY!, }); iframe.src = url; 容器.style.display = "块"; } #### `anim-webview-mobile` – 在 WebView 中加载动画（React Native） // 动画播放器.tsx 从“反应”导入反应；从“react-native-webview”导入{WebView}；从“../types”导入{buildAnimationUrl}；接口道具 { matchId：号码；访问密钥：字符串； } 导出 const AnimationPlayer: React.FC = ({ matchId, accessKey }) => { const url = buildAnimationUrl({ matchId, accessKey }); 返回（ <网页视图来源={{ uri: url }} 样式={{ 弹性: 1 }} 允许全屏视频 mediaPlaybackRequiresUserAction={false} /> ）； }; #### `anim-domain-whitelist` – 在控制面板中注册您的域 * 在通过 iFrame 嵌入之前，转到 **控制台面板 → 动画 → 域白名单**。 * 在使用WebView的APP平台上，不需要白名单，直接URL访问即可。 ** ** ### 4\.特定于端点的最佳实践（高） #### `ep-league-basic` – 联赛和杯赛简介（基本） **端点：** `GET /football_th/league/basic.aspx` **速率：** 硬性限制 1 小时/呼叫 · 建议 1 天/呼叫 **计划：** 所有付费足球计划（统计、实时数据、赔率、赔率 Pro、Betfair）该端点返回什么： * `leagueId` – 用于加入实时比分、赛程表、排名和赔率数据。 * `leagueName` / `leagueNameEn` – 泰语和英语显示名称。 * `countryId` / `countryName` – 按国家对联赛进行分组。 * `leagueLogo` / `countryLogo` – CDN 图像 URL。 * `类型` – `1` = 联赛，`2` = 杯赛，`3` = 国际比赛。 * `curSeasonId` – 当前活跃季节；在调用统计数据或积分榜端点时使用。 * 涵盖 **140 多个国家/地区的 1,600 多个联赛和杯赛**。 ✅ **最佳实践：** // league-service.ts 从“./types”导入{LeagueBasic，LeagueBasicResponse}；从“./utils”导入{buildUrl，cachedFetch}； /** 获取完整联赛目录并缓存 24 小时。 */ 导出异步函数 getLeagues(): Promise { 返回cachedFetch("thscore:leagues:basic", 86400, async () => { const res = wait fetch(buildUrl("/football_th/league/basic.aspx")); const json: LeagueBasicResponse =等待 res.json(); if (json.code !== 0) throw new Error(`API 错误: ${json.message}`); 返回 json.结果； }); } /** 按国家/地区对联赛进行分组，以提供国家/地区选择器 UI */ 导出函数 groupByCountry(leagues: LeagueBasic[]): Record { 返回 leagues.reduce((acc, league) => { const key = league.countryNameEn; if (!acc[key]) acc[key] = []; acc[key].push(联盟); 返回帐户； }, {} as Record); } /** 仅过滤杯子 */ 导出函数 getCups(leagues: LeagueBasic[]): LeagueBasic[] { return leagues.filter(l => l.type === 2); } /** 按名称查找联赛（不区分大小写） */ 导出函数 findLeague(leagues: LeagueBasic[], name: string): LeagueBasic |未定义{ const q = name.toLowerCase(); return leagues.find(l => l.leagueNameEn.toLowerCase().includes(q)); } #### `ep-league-full` – 联赛和杯赛简介（完整） **端点：** `GET /football_th/league.aspx` **速率：** 硬性限制 30 分钟/调用 · 建议 1 天/调用 **计划：** 仅实时数据基本之外的其他字段： * `seasonId`, `seasonName` – 活跃季节详细信息（例如，“2024-2025”） * `startDate`, `endDate` – 季节日期范围 * `primaryColor`, ` secondaryColor` – UI 主题的品牌颜色 * `totalTeams` – 参赛球队数量 * `officialSite` – 联赛官方网站 **还支持：** `GET /football_th/league.aspx?cmd=rule` 以纯文本/HTML 形式返回联赛规则 – 对于联赛信息页面很有用。 #### `ep-livescores` – 今天的实时比分 **端点：** `GET /football_th/livescores.aspx` **速率：** 硬限制 10 秒/调用 · 建议 1 分钟/调用 **计划：** 实时数据要使用的关键响应字段： * `state` → 映射到 `MatchState` 枚举 * `elapsed` → 显示实时比赛时钟 * `homeScore`, `awayScore`, `homeHalfScore`, `awayHalfScore` → 记分卡 * `homeCorner`, `awayCorner` → 角球计数 * `homeRed`, `awayRed` → 红牌指示器 * `hasAnimation` → 用于显示动画嵌入按钮的门 // livecores.service.ts 从“./types”导入{ LivescoresResponse、LiveMatch、MatchState、MatchStateLabel }；从“./utils”导入{buildUrl，cachedFetch}；导出异步函数 getLivescores(): Promise { 返回cachedFetch("thscore:livescores", 60, async () => { const res = wait fetch(buildUrl("/football_th/livescores.aspx")); const json: LivescoresResponse =等待 res.json(); if (json.code !== 0) throw new Error(`[Livescores] API 错误 ${json.code}: ${json.message}`); 返回 json.结果； }); } /** 仅返回当前正在进行的比赛 */ 导出函数 getInPlayMatches(matches: LiveMatch[]): LiveMatch[] { 常量 inPlayStates = [ MatchState.FirstHalf，MatchState.HalfTime， MatchState.SecondHalf、MatchState.ExtraTimeFirst、 MatchState.ExtraTimeHT、MatchState.ExtraTimeSecond、 MatchState.点球大战， ]; 返回 matches.filter(m => inPlayStates.includes(m.state)); } /** 返回一个适合显示的分数字符串，例如“2-1（1-0）”*/ 导出函数 formatScore(match: LiveMatch): string { 返回 `${match.homeScore} - ${match.awayScore} (HT: ${match.homeHalfScore} - ${match.awayHalfScore})`; } /** 显示友好的状态以及经过的分钟数 */ 导出函数 formatStatus(match: LiveMatch): string { const label = MatchStateLabel[match.state] ?? “未知”; if (match.elapsed > 0 && match.state === MatchState.FirstHalf || match.state === MatchState.SecondHalf) { 返回 `${label} ${match.elapsed}'`; } 退货标签； } #### `ep-stands` – 联赛和杯赛排名 **端点：** `GET /football_th/league/table.aspx`（参见文档 #43） **计划：** 统计要显示的响应字段： * `rank` – 表中的位置 * `played`, `won`, `draw`, `lost` – 比赛记录 * `goalsFor`, `goalsAgainst`, `goalDifference` – 目标统计 * `points` – 总积分 * `form` – 最后 5 个结果的数组 `["W","W","D","L","W"]` * `winRate`、`drawRate`、`loseRate` – 百分比统计（对于分析选项卡有用） // 积分榜.service.ts 从“./types”导入{StandingRow，StandingsResponse}；从“./utils”导入{buildUrl，cachedFetch}；导出异步函数 getStandings(leagueId: number, seasonId: number): Promise { const key = `thscore:积分榜:${leagueId}:${seasonId}`; 返回cachedFetch(key, 3600, async () => { const res = 等待 fetch(buildUrl("/football_th/league/table.aspx", { leagueId: 字符串(leagueId), seasonId: 字符串(seasonId), })); const json: StandingsResponse =等待 res.json(); if (json.code !== 0) throw new Error(`[Standings] API 错误：${json.code}`); 返回 json.结果； }); } /** 对表单结果进行颜色编码以供 UI 渲染 */ 导出函数 formBadgeColor(结果: string): string { 返回结果===“W”？ “绿色”：结果===“D”？ “灰色”：“红色”； } ** ** ### 5\.错误处理和弹性（高） #### `error-retry-backoff` – 使用指数退避来重试瞬态错误 // utils/http.ts 导出异步函数 fetchWithRetry(url: string, maxRetries = 3): Promise { for (让尝试 = 0;尝试 < maxRetries;尝试++) { 尝试{ const 控制器 = new AbortController(); const 超时 = setTimeout(() =>controller.abort(), 8000); // 8秒超时 const res = wait fetch(url, { signal:controller.signal }); 清除超时（超时）； if (res.ok) 返回 res; if (res.status >= 500) throw new Error(`服务器错误 ${res.status}`); throw new Error(`客户端错误 ${res.status}: ${res.statusText}`); } 捕获（错误）{ if (attempt === maxRetries - 1) 抛出错误； const 延迟 = 1000 * Math.pow(2, 尝试); // 1 秒、2 秒、4 秒 console.warn(`[THScore] 尝试 ${attempt + 1} 失败。在 ${delay} 毫秒后重试...`); 等待新的 Promise(r => setTimeout(r, 延迟)); } } 抛出新错误（“无法访问”）； } #### `error-graceful-degrade` – API 不可用时显示陈旧数据导出异步函数 getLivescoresSafe(): Promise { 尝试{ 返回等待 getLivescores(); } 捕获（错误）{ console.error("[THScore] 比分不可用，提供陈旧的缓存：", err); const stale = wait redis.get("thscore:livescores:stale"); 返回陈旧？ JSON.parse(陈旧) : []; } } // 成功获取后，始终保留“过时”备份异步函数 fetchAndPersist(): Promise { const data = 等待 getLivescores(); 等待 redis.set("thscore:livescores:stale", JSON.stringify(data)); // 无 TTL = 永远等待 redis.setex("thscore:livescores", 60, JSON.stringify(data)); } ** ** ### 6\.数据标准化和类型（中） #### `data-map-on-ingestion` – 立即将 API 形状转换为您的内部类型切勿将原始 THScore JSON 直接传递到您的 UI 或数据库。始终通过类型化变压器进行映射。 // 映射器.ts 从“./types”导入{LiveMatch，MatchState}； /** 来自 API 的原始形状（不受信任，未键入）*/ 接口原始匹配{ matchId：号码；状态：数量；主页名称：字符串；离开名称：字符串；主场得分：数字；客场得分：数字； hHalf：数字； aHalf：数字； // ...更多原始字段 } 导出函数mapRawMatch(raw: RawMatch): LiveMatch { 返回{ matchId: raw.matchId, 主场球队名称：raw.homeName, awayTeamName: raw.awayName, 主页得分：raw.homeScore ?? 0, awayScore: raw.awayScore ?? 0, homeHalfScore: raw.hHalf ?? 0, awayHalfScore：raw.aHalf ?? 0, 状态：raw.state 作为 MatchState， hasAnimation: Boolean(raw.animId), 动画匹配Id：raw.animId ??未定义， // ... 映射剩余字段作为LiveMatch； } ** ** ### 7\.安全（关键） #### `security-proxy-all` – 始终通过后端代理 > THScore 不支持 CORS。任何从浏览器直接发送到“thscore.info”的请求都将被阻止。您的 API 密钥将在网络日志中保持公开状态。 ✅ **架构：** 浏览器/应用程序 │ ▼ 你的后端 (Node / PHP / Python) ← 持有 THSCORE_API_KEY │ ▼ api2.thscore.info / www.thscore.info //routes/football.ts（Express 示例） router.get("/livescores", async (req, res) => { const data = 等待 getLivescoresSafe(); res.json(数据); // ← 永远不要向客户端公开原始 API 密钥 }); ** ** ## 官方文档参考主题 |网址 ---|--- 开始使用 | 足球API 联赛和杯赛简介（基本）| `/football_th/league/basic.aspx` 联赛及杯赛简介（完整）| `/football_th/league.aspx` 今日比分 | `doc/docs_id=20` · `/football_th/livescores.aspx` 日程和结果 | `doc/docs_id=21` · `/football_th/schedule/results.aspx` 赛事与统计（比赛）| `doc/docs_id=15` 阵容与伤病| `doc/docs_id=17` 联赛及杯赛积分榜| `doc/docs_id=43` 最佳射手 | `doc/docs_id=39` 国际足联排名 | `doc/docs_id=47` 实时动画配置 | `doc/docs_id=242` 动画直播 URL 演示 | 所有足球联赛列表|

足球比分 API

包含技能