4.4 接口地图:46 个接口的分组导航与选型建议
地图
内容太多,看不完或者看不太懂?
复制一段话发给你的 AI,它会自己读完官方文档、装好技能包,再来回答你的问题。
点这里复制给 AI →
想知道每项数据覆盖了哪些赛事?
88 项赛事的数据项覆盖情况一览:赛程比分、首发阵容、球员与球队统计、进阶指标、伤停、天气等,每日自动统计并如实公开。
查看数据覆盖说明 →
把下面这段发给你的 AI,它就知道该做什么
点「复制全文」,粘贴到你的 AI 对话框发送即可,无需改动。
你正在阅读球小策(www.qiuxiaoce.com)的官方文档或数据服务页面。请按下面 5 步执行,不要跳步。
【预备】我的专属数据密钥是 X-API-Key = [在此粘贴你的 Key]
(第 2 步和第 3 步都会用到它;还没有密钥,先到 https://www.qiuxiaoce.com/data-account/ 免费领取)
━━━ 第 0 步 · 三条硬性纪律 ━━━
1. 凡涉及指标定义、接口参数、计费规则、准确率口径的问题,一律以站内官方文档为准,不要凭记忆作答;文档里没写的,就直接告诉我「文档未说明」。
2. 如果你无法访问下面任何一个网址,请立刻停下来告诉我,不要用记忆里的内容顶替。
3. 本站只做数据分析,不提供任何投注建议,也不做准确率承诺。回答时请守住这条边界。
━━━ 第 1 步 · 遍历官方文档(100+ 篇,按需取,别一次全拉)━━━
· 取全量目录(公开接口,无需密钥,返回全部篇章的标题与 slug):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs
· 读单篇正文(把 {slug} 换成上一步拿到的标识):
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/docs/{slug}
· 人读版页面(适合只能浏览网页、拿不到 JSON 的环境):
https://www.qiuxiaoce.com/creator-docs/{slug}/
· 接口文档(全部数据接口的用途、参数、计费与真实返回示例):
https://www.qiuxiaoce.com/data-docs/
做法:先取目录 → 判断我的问题涉及哪几篇 → 只读那几篇 → 回答时注明依据的篇名或链接。
━━━ 第 2 步 · 先判断你自己的能力,再选路径(关键,不可跳过)━━━
· A 类:能在本机读写文件或执行命令——桌面/终端类 AI 工具(WorkBuddy、Qoder、Trae 等)
· B 类:只能对话,访问不了文件系统——网页版对话(豆包、通义千问、Kimi 等)
【A 类 · 安装官方 Skill(推荐)】
1. 取最新版本信息:
GET https://www.qiuxiaoce.com/wp-json/abv2-creator/v1/skill/version
返回 version、download_url、sha256 校验清单、文件列表与更新说明。
2. 按 download_url 下载技能包,并用返回的 sha256 逐文件校验。
3. 解压到你的技能目录,保持包内顶层目录结构;按包内 SKILL.md 完成初始化。
4. 写入我的专属密钥(即上文【预备】里的 X-API-Key)。
5. 装完告诉我:版本号、安装位置、密钥是否已生效。
【B 类 · 装不了就照实说,不要假装】
不要声称已安装,也不要拿记忆里的内容替代文档。请直接对我说:
「当前环境不支持安装 Skill(无法读写本地文件)。有两个办法:
① 改用支持 Skill 的桌面 AI 工具,如 WorkBuddy、Qoder、Trae;
② 把你的 API Key 给我,我按官方接口文档直接取数分析。」
如果你连「打开指定网址」都做不到,请把这一点也一并告诉我。
━━━ 第 3 步 · 直接用接口取数(两条路径都适用)━━━
· 接口根地址:https://www.qiuxiaoce.com/wp-json/abv2-creator/v1
· 认证方式:请求头带上【预备】里的 X-API-Key
· 想先试不扣点数的接口,看 https://www.qiuxiaoce.com/data-docs/ 里标注为免费的端点。
· 大批量调用前先查一次剩余点数,避免跑到一半失败。
━━━ 第 4 步 · 遇到报错,先查官方排障手册再重试 ━━━
排障手册:https://www.qiuxiaoce.com/creator-docs/api-error-codes-troubleshooting/
· 401:Key 缺失、格式不对,或该 Key 已被重置/吊销(控制台执行「重置 Key」后旧 Key 立即失效,错误码 api_key_revoked 即属此类)→ 到 https://www.qiuxiaoce.com/data-account/ 复制最新完整 Key,并同步更新所有已配置该 Key 的脚本与客户端
· 402:点数不足或已过期 → 需到 https://www.qiuxiaoce.com/data-service/ 充值
· 403:接口未开放,或权限不足(个别场次报告需要订阅)
· 404:实体 ID 或接口路径写错
· 429:请求过快,按响应头 Retry-After 等待后重试
报错时请把原始错误信息原样转述给我,不要猜原因。
━━━ 第 5 步 · 回答我时的要求 ━━━
· 区分「官方事实数据」「接口返回的判断字段」「衍生评分」「你自己的推断」四类,不要混着说。
· 使用 xG、xGA、OTI、DII 这类指标前,先按文档校正口径;样本不足要在结论里注明。
· 缺数据就说缺什么,不要用「大概」「可能」糊过去。
· 不给投注建议,不承诺准确率。
· 如果回答主要依据了某篇文档,请把链接带上,方便我自己核对。
复制后直接发给你的 AI(豆包、千问、WorkBuddy、Qoder 等都可以)。
这一篇是接口导航。不需要背,用的时候回来查就行。
一、按场景选接口:我该用哪个?
先用这张表定位,再跳到下面看参数。
| 我想做的事 | 用哪个接口 | 点数 |
|---|---|---|
| 今天有哪些比赛?有竞彩编号吗? | /today/digest |
5 |
| 某一天 / 某个联赛 / 某支球队的赛程 | /fixtures |
2 |
| 看一场比赛的全部维度 | /match-pack/{id} |
50 |
| 看已完赛的技术统计 / 事件 / 阵容 / 球员评分 | /fixtures/{id}/stats|events|lineups|players |
各 5 |
| 两队历史交锋 | /h2h |
5 |
| 一支球队的实力画像 | /teams/{id}/advanced |
10 |
| 一支球队的核心球员 | /teams/{id}/players-advanced |
10 |
| 伤停名单 | /teams/{id}/injuries |
5 |
| 某名球员的高阶指标 | /players/{id}/advanced |
3 |
| 积分榜 / 射手榜 / 助攻榜 | /standings | /leagues/{id}/topscorers|topassists |
3 / 5 |
| 市场参考值现在多少、有没有变化 | /fixtures/{id}/quotes | /quotes/history | /market |
各 5 |
| 转会记录 / 教练履历 / 裁判风格 | /transfers | /coaches/{id} | /referees/{id} |
5 / 3 / 3 |
| 预测准不准(复盘与命中率) | /stats/overall | /stats/team | /review |
5 / 5 / 10 |
| 官方研报全文 | /posts/{id}(历史 25 / 当天 100);批量用 /posts |
25 / 1000 |
还有一件重要的事:任何数据接口之前,几乎都要先拿一个数字 ID。球队用 /teams?q=队名,球员用 /players?q=姓名,联赛用 /leagues?q=名称,比赛用 /fixtures?date= 或 /today/digest。
二、46 个接口分别是什么?
按功能分成 8 组。点数已标注,方便你估算成本。
账户组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/quota |
余额自查(含有效期与限流配置) | 0 |
赛事与赛程组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/today/digest |
今日赛事总览(含竞彩/北单编号) | 5 |
/fixtures |
比赛日程(按日期 / 联赛 / 球队筛选) | 2 |
/fixtures/{id} |
单场比赛详情(含球场、裁判、比分分段) | 2 |
/fixtures/{id}/stats |
单场技术统计 | 5 |
/fixtures/{id}/events |
单场事件流(进球、换人、牌) | 5 |
/fixtures/{id}/lineups |
单场官方阵容与阵型 | 5 |
/fixtures/{id}/players |
单场球员逐场统计与评分 | 5 |
/h2h |
两队历史交锋 | 5 |
单场全景组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/match-pack/{id} |
单场全景数据包(一次覆盖全部维度,内置市场波动) | 50 |
/tasks/{id} |
完整包生成进度查询 | 0 |
市场参考值组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/fixtures/{id}/quotes |
市场参考值当前快照(含官方公开参考值) | 5 |
/fixtures/{id}/quotes/history |
市场参考值时间序列(含开盘与临场标记) | 5 |
/fixtures/{id}/market |
已识别的市场异动事件流 | 5 |
球队组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/teams?q= |
球队搜索(拿 team_id) | 2 |
/teams/{id} |
球队详情(三字码、国家、球场、容量) | 2 |
/teams/{id}/form |
近期战绩(近 N 场逐场) | 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(最多 20 人,一次取全) | 10 |
球员、教练与裁判组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/players?q= |
球员搜索(拿 player_id) | 2 |
/players/{id} |
球员详情(含现属球队、身价) | 2 |
/players/{id}/stats |
球员赛季统计 | 3 |
/players/{id}/advanced |
球员高阶指标(只用于查一个人) | 3 |
/coaches/{id} |
教练详情与执教履历 | 3 |
/referees?q= |
裁判搜索 | 2 |
/referees/{id} |
裁判详情与执法数据 | 3 |
联赛与转会组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/leagues |
联赛列表 / 搜索 | 2 |
/leagues/{id} |
联赛详情(可附带积分榜) | 3 |
/leagues/{id}/teams |
参赛球队 | 2 |
/leagues/{id}/seasons |
赛季列表(不确定赛季口径时先查) | 1 |
/leagues/{id}/fixtures |
赛季逐场赛果 | 5 |
/leagues/{id}/topscorers |
射手榜 | 5 |
/leagues/{id}/topassists |
助攻榜 | 5 |
/standings |
积分榜 | 3 |
/transfers |
转会记录(按球队或球员) | 5 |
报告与复盘组有哪些接口?
| 接口 | 用途 | 点数 |
|---|---|---|
/posts/today |
当天全部官方研报(批发) | 1000 |
/posts |
指定日期全部研报(批发) | 1000 |
/posts/{id} |
研报全文 + 结构化预测 | 25 / 当天 100 |
/review |
近 N 天预测复盘聚合 | 10 |
/stats/overall |
整体命中率快照 | 5 |
/stats/team |
某支球队的历史研报命中情况 | 5 |
小计:1 + 8 + 2 + 3 + 10 + 7 + 9 + 6 = 46 个接口。其中 2 个是免费接口(余额自查、生成进度),最贵的是研报批发(1000 点)与单场全景包(50 点)。
三、最常用的三个接口是哪几个?
如果只记三个,记这三个——它们覆盖了八成日常场景:
| 接口 | 为什么常用 | 点数 |
|---|---|---|
/today/digest |
一眼看今天全部比赛,还带竞彩/北单编号,是选题的起点 | 5 |
/match-pack/{id} |
一场比赛的全部维度,写单场内容的唯一主力 | 50 |
/teams/{id}/players-advanced |
一次拿一队最多 20 人的高阶指标,球员内容的性价比之王 | 10 |
四、选型有哪三条原则?
原则一:能用批量就不用循环。同一类数据、多个对象,先找批量入口:一场比赛用全景包、一队球员用 players-advanced、当天赛事用 digest。
原则二:先用最便宜的接口确认 ID,再调贵的。搜索(2 点)→ 确认 → 详情/高阶(10~50 点)。顺序反了,就用最贵的接口在试错。
原则三:研报类先看官网。/posts 系列单次 25~1000 点,只是想读一读的话没必要花:历史复盘与命中统计 | 今日赛事前瞻。
💬 不知道该用哪个接口?问它(复制发送) 地图
我想做一件事:【用一句话说清你要做什么,例如「分析明天拜仁那场比赛」】。
请按下面的顺序回答,不要直接开始调用:
1. 完成这件事需要哪几个接口?按调用顺序列出,每个都标注点数和用途;
2. 每一步需要什么参数?我手上还没有的信息,告诉我该怎么拿到(例如球队 ID 要先搜索);
3. 总点数是多少?有没有更省的做法(能合并的合并、能用批量的别循环);
4. 其中有没有哪些内容其实不需要调接口、官网直接看就行?如果有,给我链接。
约束:接口名必须来自球小策创作者 API 的真实接口,不要编造;不确定的点数标注「需确认」。
下一步该看什么
- 赛程域怎么用 → 4.5 核心接口精讲①
- 单场全景包怎么用 → 4.6 核心接口精讲②
- 球队与球员档案 → 4.7 核心接口精讲③
足球赛事前瞻 | AI 智能分析 | 足球数据解读 - 球小策