第一次调用 API，并不需要先学习编程。我们只需要准备一个 API 测试工具，把接口地址和查询日期填进去，再点击一次“发送”，服务器就会把数据返回。

这篇文章使用 Apifox 调用鸟叫足球数据 API 的“大球概率”接口，完成一个非常简单的目标：

不写代码，查询指定日期的比赛，并看到每场比赛总进球超过 2.5 球的概率数据。

鸟叫 API 的大球概率接口为 /api/v1/prob/over，支持通过日期或比赛 ID 查询，使用 GET 请求，返回 JSON 数据。
官方接口说明页面：(njstats.cn)

API 可以理解成什么？

可以把 API 理解成一个“数据水龙头”。

平时想查看比赛数据，可能需要打开网页，再一场一场寻找和复制。

使用 API 后，我们只需要告诉程序：

• 去哪个数据入口；
• 我们有没有访问权限；
• 想查询哪一天；
• 每次想返回多少场比赛。

服务器就会按照固定格式，把数据返回。

Apifox 的作用，可以简单理解成：

帮我们打开这个数据水龙头，并把流回来的数据展示在屏幕上。

这一期不搭数据库，也不写程序，只完成第一次请求。

开始前需要准备什么？

本次操作需要准备：

1. Apifox ；
2. 鸟叫足球 API Key；
3. 一个有比赛数据的日期；
4. 大球概率接口地址。

请求地址为：

https://api.njstats.cn/api/v1/prob/over

鸟叫 API 使用查询参数中的 apikey 进行身份验证，业务接口使用 GET 请求，返回格式为 JSON。API Key 相当于个人访问凭证，不应该公开或分享。

第一步：打开 Apifox，新建快捷请求

打开 Apifox 后，新建一个快捷请求。

请求方式选择：

GET

新手不需要背诵 GET 的技术定义。

只需要知道：

今天我们要从服务器拿数据，所以选择 GET。

然后，在请求地址栏输入：

https://api.njstats.cn/api/v1/prob/over?apikey=<YOUR_API_KEY>

这个地址可以理解成“大球概率数据”的专用入口。

第二步：填写查询参数

在 Apifox 请求地址下方，找到 Params，也就是查询参数区域。

只需要填写以下参数：

apikey = 你的API密钥

第三步：点击“发送”

接口地址和参数填写完成后，点击 Apifox 右上方的“发送”。

如果请求正常，下面会出现服务器返回的数据。

请求已经顺利到达服务器，服务器也正常回复了我们。

第四步：怎么看返回的数据？

新手第一次看到 JSON，可能会觉得满屏括号、逗号和英文，不知道从哪里开始。

真正需要的比赛和概率数据，主要在：

{
  "data": []
}

展开 data 中的一条记录后，可以重点寻找：

• 比赛 ID；
• 联赛名称；
• 主队；
• 客队；
• 开赛时间；
• 大球概率；
• 主客队相关统计；
• 数据更新时间。

不同版本的实际字段名称可能有所变化，应以当前接口真实返回结果和官方文档为准，不要根据中文含义自行猜字段。

大球概率应该怎么理解？

假设某场比赛返回的大球概率为：

68%

它表示：

根据当前模型和已有数据，这场比赛总进球超过 2.5 球的估计概率为 68%。

概率数据更适合用来：

• 从大量比赛中快速筛选；
• 对比不同比赛的进球倾向；
• 结合球队状态和比赛统计继续研究；
• 建立自己的数据表或筛选工具；
• 进行长期样本复盘。

• Excel；
• CSV；
• SQLite 数据库；
• 网页数据看板；
• 每日比赛筛选表；
• 自动更新的概率排行。

所以，Apifox 的作用是先确认：

这个接口能不能正常返回数据，返回的数据大概长什么样。

确认接口可用之后，再考虑自动化。

如何查询指定比赛？

除了按日期查询，大球概率接口也支持通过 matchIds 查询指定比赛。

例如：

matchIds = 24691988

查询多场比赛时，使用英文逗号分隔：

matchIds = 24691988,24692021

完整参数可以是：

不过这更适合后续教程。

第一次调用优先使用 date，因为操作链路最短，不需要先获取比赛 ID。

常见问题

点击发送后提示 API Key 无效

检查以下内容：

• Key 是否复制完整；
• Key 前后有没有多余空格；
• 环境变量是否选择了正确环境；
• 参数名是否为 apikey；
• Key 是否已经失效。

不要把完整 Key 发到群里让别人帮忙排查。

为什么只返回部分比赛？

可能是分页导致的。

检查：

page
pageSize
pager

先确认当前返回的是第几页，总共有多少条数据。

完成第一次请求后，可以做什么？

当大球概率接口能够正常返回数据以后，下一步可以开始做实际应用。

例如：

导出 Excel

将每天的比赛整理为：

再按照概率从高到低排序。

建立历史数据库

每天保存一次赛前概率，并在比赛结束后补充最终比分，用来观察概率区间的长期表现。

制作筛选器

例如筛选：

• 大球概率超过某个数值；
• 主客队近期场均总进球较高；
• 大球概率和双方进球概率同时较高；
• 数据样本相对完整的比赛。

交给 Codex 自动处理

把 API 文档交给 Codex，让它：

• 自动调用接口；
• 每天更新数据；
• 保存进 SQLite；
• 导出 Excel；
• 生成数据看板；
• 对历史结果进行复盘。

整个学习路径可以分成：

Apifox 查看接口能否返回
          ↓
看懂日期、参数和 JSON
          ↓
用 Codex 自动调用
          ↓
保存到 Excel 或数据库
          ↓
长期积累和复盘

总结

使用 Apifox 调用大球概率接口，只需要理解五件事：

1. 请求方式：使用 GET 获取数据；
2. 接口地址：/api/v1/prob/over；
3. API Key：证明你有调用权限；
4. 返回结果：在 data 中查看比赛和概率数据。

只要在 Apifox 中完成：

填写地址 → 填写 Key → 点击发送 → 看到概率数据返回

第一次 API 请求就已经成功了。

最后

本次演示使用的是鸟叫足球数据 API 的大球概率接口。

需要 API 测试体验，或者希望获取后续的 Apifox、Codex、Excel 和足球数据库教程，可以私信关键词：

API数据来源：NJSTATS.CN