API 是什么？
你平时看到的足球比分网站，如雷速、500、澳客、包括鸟叫，你可能好奇这些网站的数据是怎么来的，其实很简单，这些网站的数据都是通过数据商提供的API自动返回。
顶级数据商如英超官方合作伙伴opta，他们提供球员穿戴设备和场地设备，采集得到数据，再把数据加工提供给下游，费用非常昂贵一年动辄几十上百万，通常只有企业才能承担昂贵数据费用，普通个人用户一般无法接触到这些高阶数据。但是现在鸟叫数据团队，让每一个普通用户也可以用极地的成本用上高阶足球数据API了。
我们再说回API，你可以把 API 理解成一个「数据水龙头」。
使用 API ，第一步先看API文档，它是使用说明书。数据信息都写在文档里的，比如指数数据在哪个水龙头（接口）、赛程数据在哪个水龙头（接口），球员数据在哪个水龙头（接口），每个水龙头开多大，每分钟能接多少水（请求频率限制），都在说明书里面。
说明书很重要，你只需要把文档地址喂给AI，让AI帮你解读接口能力，非常简单。家长花钱买志愿咨询的生意之所以火爆，就是很多家长连最基本的说明书都不愿意看。
🫰
这一期不做其他事，只完成第一次API接口请求，看看数据到底长啥样
第一次调用 API，我们只需要准备一个 API 调试工具，把API接口地址填进去，再点击一次“发送”，服务器就会把数据返回。
这篇文章使用 Apifox 调用鸟叫足球数据 API 的「大球概率」接口，完成一个非常简单的目标：
查询未来总进球超过 2.5 球的概率对阵比赛
开始前需要准备什么？
本次操作需要准备：
- apifox.com；
Apifox 的作用，可以简单理解成：
帮我们打开这个数据水龙头，并把流回来的数据展示在屏幕上。
2.鸟叫足球API文档和 API Key；
前面我们说了，文档就是是使用说明，API Key 相当于个人访问凭证，不应该公开或分享。
3.大球概率接口地址。
请求地址为：
https://api.njstats.cn/api/v1/prob/over?apikey=
把上面地址中替换成你自己的密钥就行，不需要<>符号。
第一步：打开 Apifox，新建快捷请求
打开 Apifox 后-新建项目-新建一个快捷请求。
请求方式选择：
GET
新手不需要知道 GET 的技术定义。
只需要知道：
今天我们要从服务器拿数据，所以选择 GET。
然后，在请求地址栏复制粘贴「大球接口」地址：
https://api.njstats.cn/api/v1/prob/over?apikey=
这个接口地址自动返回未来大球比赛对阵
第二步：填写查询参数
在 Apifox 请求地址下方，找到 Params，也就是查询参数区域。
从鸟叫复制粘贴你的密钥：
apikey = 你的API密钥
第三步：点击“发送”
接口地址和参数填写完成后，点击 Apifox 右上方的“发送”。
如果请求正常，恭喜你！下面会出现鸟叫返回的数据。
请求已经顺利到达服务器，服务器也正常回复了我们。
第四步：怎么看返回的数据？
新手第一次看到 JSON，满屏括号、逗号和英文，不知道从哪里开始。不必担心，你已经成功请求到了数据，剩下的可以交给AI可以帮你搞成中文，数据清理都可以交给AI。
数据主要如下示例：
{
"data": []
}
- 比赛 ID；
- 联赛名称；
- 主队；
- 客队；
- 开赛时间；
- 大球概率；
- 主客队相关统计；
- 数据更新时间。
当前接口真实返回结果以鸟叫官方文档为准。
👏
后续可以让 Codex、Workbuddy 或其他AI工具把数据转换成：
- Excel；
- 数据库；
- 网页数据看板；
- 每日比赛筛选表；
- 自动更新的概率排行。
所以，Apifox 的作用是先确认：
这个接口能不能正常返回数据，返回的数据大概长什么样。
确认接口可用之后，再让AI接手实现自动化。
如何查询指定比赛？
除了按日期查询，大球概率接口也支持通过 matchIds 查询指定比赛。
例如：
matchIds = 24691988
查询多场比赛时，使用英文逗号分隔：
matchIds = 24691988,24692021
完整参数可以是：
| 参数 | 参数值 |
|---|
apikey | {{NJSTATS_API_KEY}} |
matchIds | 24691988,24692021 |
page | 1 |
pageSize | 20 |
不过这更适合后续教程。
第一次调用优先使用 date，因为操作链路最短，不需要先获取比赛 ID。
常见问题
点击发送后提示 API Key 无效
检查以下内容：
- Key 是否复制完整；
- Key 前后有没有多余空格；
- 环境变量是否选择了正确环境；
- 参数名是否为
apikey； - Key 是否已经失效。
不要把完整 Key 发到分享或暴露给别人。
为什么只返回部分比赛？
数据过多可能有分页，你只看到第一页，需要翻页。
检查：
page
pageSize
pager
先确认当前返回的是第几页，总共有多少条数据。
完成第一次请求后，可以做什么？
当大球概率接口能够正常返回数据以后，下一步可以开始做实际应用。
例如：
导出 Excel
将每天的比赛整理为：
再按照概率从高到低排序。
建立历史数据库
每天保存一次赛前概率，并在比赛结束后补充最终比分，用来观察概率区间的长期表现。
制作筛选器
例如筛选：
- 大球概率超过某个数值；
- 主客队近期场均总进球较高；
- 大球概率和双方进球概率同时较高；
- 数据样本相对完整的比赛。
交给 Codex等AI 自动处理
把 API 文档交给 Codex，让它：
- 自动调用接口；
- 每天更新数据；
- 保存进 SQLite；
- 导出 Excel；
- 生成数据看板；
- 对历史结果进行复盘。
整个学习路径可以分成：
Apifox 查看接口能否返回
↓
看懂日期、参数和 JSON
↓
用 Codex 自动调用
↓
保存到 Excel 或数据库
↓
长期积累和复盘
总结
只要在apifox.com中完成：
填写地址 → 填写 Key → 点击发送 → 看到概率数据返回
1.鸟叫API接口文档：
https://www.njstats.cn/data-api/docs/5-0
2.API Key：你的使用权限；
https://www.njstats.cn/data-api/account
3.大球接口请求地址：
https://api.njstats.cn/api/v1/prob/over?apikey=；
4.请求方式：使用 GET 获取数据；
5.返回结果：在 data 中查看比赛和概率数据。
👏恭喜！API 已经成功了！
如果在使用中遇到问题，一定要多问AI。
接下来，让我们一起使用鸟叫足球数据API，进阶更高阶的足球数据预测建模！
