足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策4.7 核心接口精讲③：球队与球员高阶档案
精讲这一篇讲球队域和球员域。核心是三个「值钱」的接口：球队高阶画像、伤停名单、球员高阶指标。
一、球队域接口全景
| 接口 | 用途 | 点数 |
|---|---|---|
/teams |
球队搜索（拿 ID） | 2 |
/teams/{id} |
球队详情 | 2 |
/teams/{id}/form |
近期战绩 | 5 |
/teams/{id}/fixtures |
逐场赛程历史 | 3 |
/teams/{id}/statistics |
赛季统计 | 5 |
/teams/{id}/advanced |
高阶画像 | 10 |
/teams/{id}/injuries |
伤停名单 | 5 |
/teams/{id}/squad |
阵容 | 3 |
/teams/{id}/coach |
教练信息 | 3 |
/teams/{id}/players-advanced |
队内球员高阶 TOP | 10 |
二、重点接口一：/teams/{id}/advanced（10 点）
它返回什么
球队的高阶画像，即本文档 3.1 中「第 3 层」数据：攻防效率、战术风格特征、阶段性表现等。
为什么它比 /statistics 贵（10 点 vs 5 点）
| 对比项 | /statistics | /advanced |
|---|---|---|
| 数据层级 | 基础统计（射门、控球） | 高阶指标（xG、攻防实时指数） |
| 可直接用于判断 | 否，需要自己加工 | 是 |
| 建模成本 | 低 | 高（需跨赛季标定） |
典型用法
- 评估对手的真实实力（而非看积分榜）；
- 识别球队的战术风格（靠锋线还是靠中场）；
- 发现「战绩与实力不符」的球队。
三、重点接口二：/teams/{id}/injuries（5 点）
这是性价比最高的接口之一
5 点，就能拿到球队的伤停名单。这是修正所有其他指标的前提。
使用要点
| 要点 | 说明 |
|---|---|
| 区分状态 | 确认缺阵 / 出战成疑 / 已恢复，三者意义完全不同 |
| 看位置 | 缺阵位置决定影响哪类指标（见 3.6） |
| 看替补落差 | 结合 /squad 判断替补水平差距 |
💬 可复制指令
下面是某支球队的伤停名单与阵容信息。
请完成两件事：
1. 判断每一项缺阵对球队攻防体系的具体影响（影响哪个区域、哪类指标）；
2. 给出该队本场「阵容完整度」的定性评估（完整 / 轻度折损 / 中度折损 / 重度折损），并说明理由。
约束：
- 只基于我给的数据，不要引入外部信息；
- 不要给出比分预测；
- 每一条判断都要说明影响的是进攻端还是防守端。
数据：
[粘贴伤停与阵容]
四、球员域接口
| 接口 | 用途 | 点数 |
|---|---|---|
/players |
球员搜索 | 2 |
/players/{id} |
球员详情 | 2 |
/players/{id}/stats |
赛季统计 | 3 |
/players/{id}/advanced |
球员高阶指标 | 10 |
/teams/{id}/players-advanced |
队内球员高阶 TOP | 10 |
什么时候用 /teams/{id}/players-advanced
当你想快速知道「这支球队谁最关键」时，用它可以一次拿到队内高阶 TOP 排行，比逐个球员查询便宜得多。
球员高阶指标的常见用途
- 判断核心球员的不可替代性（配合 3.6）；
- 写球员专题内容；
- 分析对位（哪名球员的能力正好克制对手的弱点）。
五、一个完整的球队评估流程
/teams?q=队名→ 拿球队 ID（2 点）；/teams/{id}/advanced→ 拿高阶画像（10 点）；/teams/{id}/injuries→ 拿伤停（5 点）；/teams/{id}/players-advanced→ 拿核心球员（10 点）；- 把三份数据交给 AI，让它输出球队评估。
总计 27 点，就能建立一支球队的完整档案。
六、教练与裁判
这两个维度常被忽略，但综合性价比不低：
/coaches/{id}（3 点）：执教履历与风格倾向，用于判断战术取向；/referees/{id}（3 点）：执法数据（判罚尺度、场均出牌数），影响比赛的激烈程度与犯规判罚倾向。
下一步该看什么
- 报错与限流怎么处理 → 4.8 错误码排障手册
- 把这些接口交给 AI 自动执行 → 5.1 挂载 Skill
