TheSports American Football

面向美国客户的 NFL / NCAAFB 文档重构 Demo

这个版本不复制 SportsData.io 或 Sportradar 的接口清单，而是以 TheSports AM Football 已有接口为基准：全量型接口收窄到 NFL / NCAAFB，赛季赛程改成 current season 优先，按 game/team/player ID 查询的能力归入 common 逻辑，TS 独有能力保留，TS 没有但 SR 常见的能力标为暂无。

Demo v0.7 TS-primary / SR-inspired

重构口径

客户不需要先拉全量 competition 再自己筛 NFL。US Docs 直接提供 NFL / NCAAFB 的 scoped endpoint，后台仍可复用 TS 原始接口、固定 league filter 和 season resolver。

接口归类

按联赛范围获取的数据放在 NFL / NCAAFB scope；按具体 ID 获取的数据做成同名路径模板，可复用于两个联赛；实时推送和状态码作为 common/extension 能力保留。

0TS 原始接口纳入映射
0可直接沿用或轻量重命名
0建议组合输出为客户友好接口
0SR 常见但 TS 暂无

NFL 与 NCAAFB 一套逻辑

模块
NFL scope
NCAAFB scope
Teams / Players
/v1/nfl/teams, /v1/nfl/players
/v1/ncaafb/teams, /v1/ncaafb/players
Schedules
/v1/nfl/schedules/current, /v1/nfl/schedules/date
/v1/ncaafb/schedules/current, /v1/ncaafb/schedules/date
Game ID data
/v1/nfl/games/{game_id}/statistics
/v1/ncaafb/games/{game_id}/statistics
Venue / Honor / Odds
/v1/nfl/venues, /v1/nfl/honors, /v1/nfl/odds
/v1/ncaafb/venues, /v1/ncaafb/honors, /v1/ncaafb/odds
Realtime / Push
/v1/nfl/realtime, /v1/nfl/push/events
/v1/ncaafb/realtime, /v1/ncaafb/push/events