1. v2.15.1

   最新 2026-10-22

   修复

   球员高阶选行与缺失提示

   • 球员高阶优先依据球队该赛季的联赛会员关系与实际赛程取数，不再以指标更新时间选择赛事；队内结果增加 league_id，单球员结果使用相同联赛范围。
   • 缺失提示统一为「数据暂缺」，保留缺失字段清单，不推测数据源、采集或样本原因。兼容实时快照与完整包的不同字段结构。
   • 技能包同步至 2.15.1；计费、原始数据、采集范围均未调整。
2. v2.15.0

   2026-10-22

   新增

   数据缺失说明

   • 高阶画像、队内球员高阶、球员高阶与单场全景包四个接口新增 data_coverage 字段：数据缺失时逐项列出缺失字段、原因代码与中文说明，调用方不再需要猜「是没数据还是接口坏了」。
   • 原因分为五类：数据源未覆盖（如低级别赛事与部分杯赛无 xG）、无统计样本、赛前未公布、球队未建立映射、未取得。xG 缺失时明确说明球队与球员的其它高阶指标（OTI、DII、GIM、综合评分、形态、疲劳负荷）不受影响。
   • 球队近期战绩、赛季统计、阵容、教练四个接口的空态提示补充了原因，不再只显示「暂无数据」。
   • 计费规则与单次点数未作任何调整。

   技能包

   技能包 2.15.0

   • 新增 data_coverage 解读规则：按原因代码如实告知缺失内容，不要重试同一缺数据的接口（重试仍扣点且仍为空），也不要据此判断接口故障。
3. v2.13.0

   2026-09-19

   修复

   错误响应改造

   • 所有错误响应统一为同一结构，并新增 「一句话怎么办」（hint）、「把报错转交 AI 助手」（ai_note）与对应的排障手册链接：出错时不再只看到一句技术描述，而是直接知道下一步该做什么。原有字段全部保留，不影响任何已有调用方式。
   • 修复「接口路径写错会被白扣点」：此前路径拼错时返回的是英文 404 且不进入退款流程，但点数已被扣走。现在会在计费之前就拦下，返回中文提示并明确区分「路径不存在」与「请求方式不对」，不产生任何扣点。
   • 修复内部错误暴露技术细节：部分接口出错时会把数据库报错原文回吐，可能包含内部表名与服务器路径。现在改为只记录服务端日志，对外返回友好说明加一个排查编号，客服可凭编号快速定位。
   • 明确「不扣点」承诺：密钥问题、点数不足、权限不足、路径不存在、请求过频、服务端异常 全部不扣点；若已预扣，失败时自动原路退回。

   新增

   智能体技能包

   • 技能包升级至 2.12.0：新增「错误响应与排障」章节，包含统一错误结构、处理错误的三条硬规则、两个高频误区（「404 不等于服务挂了」「429 不等于余额不足」）与错误码速查表。
4. v2.12.0

   2026-09-19

   新增

   新增接口

   • GET /fixtures/{id}/shotmap 单场射门图 —— 逐次射门的坐标、单次预期进球（xG）与射正预期进球（PSxG）、射门方式与进攻类型，并汇总双方射门分布与门将表现。
   • GET /fixtures/{id}/market-behavior 市场行为指数 —— 把市场参考值随时间的移动提炼为「移动方向与幅度、异动强度分档、机构一致性」三个结论。
   • GET /teams/{id}/venue-profile 球队主场档案 —— 场馆名称、所在城市、容纳人数、草皮类型、地址与场馆图，附历史主场战绩（胜率、场均进球与失球）。

   增强

   接口增强

   • 裁判数据更准确：同一裁判的不同姓名写法已合并统计，此前「A. Taylor」与「Anthony Taylor」会显示成两位裁判，现在归为同一人，执法场次与场均判罚数据完整。
   • 裁判倾向新增两项指标：大球率（总进球超过 2.5 的比例）与双方进球率，用于判断该裁判执法的比赛风格。
   • 球队详情新增结构化场馆信息：含草皮类型、详细地址与场馆图片。
   • 球队战术风格分类正式上线：控球压迫 / 快速反击 / 高位逼抢 / 铁血防守 / 均衡五类，并给出两队对位的参考系数。
   • 市场数据来源大幅扩展：参考值采集机构由 3 家扩展到 30 余家，同一场比赛的机构覆盖更宽。

   技能包

   技能包

   • 技能包升级至 2.11.0：新增上述三个接口的使用说明；补充裁判数据的字段口径；意图识别新增「射门质量 / 门将表现 / 主场条件 / 市场行为」场景。
5. v2.11.0

   2026-09-17

   增强

   体验优化

   • 认证失败提示细分：密钥不存在、已被重置、格式错误分别给出明确说明与解决入口，不再出现「报错但不知道怎么办」。
   • 重置密钥时强化风险提示：明确提醒旧密钥会立即失效，需同步更新脚本与 AI 工具配置。
6. v2.10.1

   2026-09-15

   增强

   体验优化

   • 接口字段命名与文档说明全面对齐，表述更中立一致，便于阅读理解。
   • 球队评分字段统一为 rating。
7. v2.9.3

   2026-09-15

   新增

   数据增强

   • 球员高阶数据新增预期进球（xG）与预期助攻（xA），并附每 90 分钟值，可通过 /teams/{id}/players-advanced 与 /players/{id}/advanced 获取。
   • 无值的字段不再出现在返回结果中，避免出现「有字段但没有数据」的困惑。
8. v2.9.0

   2026-09-10

   新增

   新增接口

   • GET /tasks/{fixture_id} 数据包生成进度查询 —— 请求单场全景数据包时，可查询生成状态，避免重复请求。
9. v2.8.0

   2026-09-01

   新增

   数据增强

   • 球员高阶评分体系上线：进攻威胁、防守参与度、比赛影响力、状态、稳定性、疲劳负荷六项指标。
10. v2.6.9

    2026-08-20

    增强

    接口增强

    • 单场全景数据包内置市场波动区块，无需额外请求即可查看市场参考值的变化与异动。
11. v2.6.0

    2026-08-10

    新增

    新增接口

    • 转会记录 GET /transfers、教练详情与执教履历 GET /coaches/{id}、裁判搜索与详情 GET /referees。
12. v2.5.0

    2026-07-28

    基础

    基础设施

    • 接口限流与返回数量上限：单分钟请求上限、单次返回条数上限，保障服务稳定。
    • 60 秒去重计费：同一密钥对同一接口同一参数的重复请求正常返回数据但不重复扣点。
13. v2.0.0

    2026-07-01

    基础

    基础设施

    • 预付点数制正式上线，全套创作者数据接口对外开放（赛程、球队、球员、联赛、研报、单场数据包）。
    • 用户中心上线：密钥管理、余额与用量查询、在线充值。
14. v1.0.0

    2026-06-01

    基础

    首次发布

    • 足球数据分析平台首次对外开放，提供赛事预测研报与基础数据接口。

想第一时间了解新接口？可在 接口文档 查看完整调用说明，或在 帮助中心 查阅图文教程。