API 是什么？

你平时看到的足球比分网站，如雷速、500、澳客、包括鸟叫，你可能好奇这些网站的数据是怎么来的，其实很简单，这些网站的数据都是通过数据商提供的API自动返回。

顶级数据商如英超官方合作伙伴opta，他们提供球员穿戴设备和场地设备，采集得到数据，再把数据加工提供给下游，费用非常昂贵一年动辄几十上百万，通常只有企业才能承担昂贵数据费用，普通个人用户一般无法接触到这些高阶数据。但是现在鸟叫数据团队，让每一个普通用户也可以用极地的成本用上高阶足球数据API了。

我们再说回API，你可以把 API 理解成一个「数据水龙头」。

使用 API ，第一步先看API文档，它是使用说明书。数据信息都写在文档里的，比如指数数据在哪个水龙头（接口）、赛程数据在哪个水龙头（接口），球员数据在哪个水龙头（接口），每个水龙头开多大，每分钟能接多少水（请求频率限制），都在说明书里面。

说明书很重要，你只需要把文档地址喂给AI，让AI帮你解读接口能力，非常简单。家长花钱买志愿咨询的生意之所以火爆，就是很多家长连最基本的说明书都不愿意看。

第一次调用 API，我们只需要准备一个 API 调试工具，把API接口地址填进去，再点击一次“发送”，服务器就会把数据返回。

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

查询未来总进球超过 2.5 球的概率对阵比赛

开始前需要准备什么？

本次操作需要准备：

1. apifox.com；

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

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

2.鸟叫足球API文档和 API Key；

前面我们说了，文档就是是使用说明，API Key 相当于个人访问凭证，不应该公开或分享。

3.大球概率接口地址。

请求地址为：

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

​把上面地址中<YOUR_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，满屏括号、逗号和英文，不知道从哪里开始。不必担心，你已经成功请求到了数据，剩下的可以交给AI可以帮你搞成中文，数据清理都可以交给AI。

数据主要如下示例：

{
  "data": []
}

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

当前接口真实返回结果以鸟叫官方文档为准。

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

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

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

确认接口可用之后，再让AI接手实现自动化。

如何查询指定比赛？

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

例如：

matchIds = 24691988

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

matchIds = 24691988,24692021

完整参数可以是：

不过这更适合后续教程。

第一次调用优先使用 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=<YOUR_API_KEY>；

4.请求方式：使用 GET 获取数据；

5.返回结果：在 data 中查看比赛和概率数据。

👏恭喜！API 已经成功了！

如果在使用中遇到问题，一定要多问AI。

接下来，让我们一起使用鸟叫足球数据API，进阶更高阶的足球数据预测建模！