拿到 Key 之后，照下面三步就能取到数据。不需要是程序员。
两种方式：
bf_ 开头）Key 就是调用接口的"通行证"，放在请求头 X-API-Key 里。
打开 在线调试台，粘贴 Key，点按钮就能看到数据。
这是最省事的方式：不用代码、不用命令行，手机浏览器也能用。
curl -H "X-API-Key: 你的KEY" "https://zqapi.com.cn/v1/matches?limit=5"
import requests
KEY = "你的KEY"
r = requests.get("https://zqapi.com.cn/v1/matches", params={"limit": 5},
headers={"X-API-Key": KEY})
for m in r.json()["matches"]:
print(m["home_cn"], "vs", m["away_cn"], m["kickoff"])
1. 数据 → 获取数据 → 来自 Web 2. 地址填：https://zqapi.com.cn/v1/matches?limit=20 3. 添加请求头：X-API-Key = 你的KEY 4. 确定 → 表格里就是数据，点"刷新"更新
导入这个地址即可获得全部接口： https://zqapi.com.cn/openapi.json
说明：ChatGPT、DeepSeek 这类网页版 AI 不能直接访问你的接口（它们没有联网调用权限）。 正确用法是下面两种：
把这段话和接口文档一起发给 AI：
我有一个足球数据 API，Key 是 你的KEY。 接口文档：https://zqapi.com.cn/openapi.json 请帮我写一个 Python 脚本：读取今天的比赛，筛选出主胜赔率低于 2.0 的场次， 输出到 Excel 文件。请求头用 X-API-Key。
如果你用 Dify、n8n、Coze、或支持 function calling 的客户端，
把 https://zqapi.com.cn/openapi.json 作为工具描述导入，AI 就能自己调接口。
注意：这需要模型/平台支持工具调用，普通网页版对话不支持。
| 功能 | 方法 | 路径 |
|---|---|---|
| 今日赛事（统一视图） | GET | /v1/matches |
| 竞彩场次 | GET | /v1/jc/matches |
| 北单场次 | GET | /v1/bjdc/matches |
| 比赛详情 | GET | /v1/bz/events/{id} |
| 阵容（首发） | GET | /v1/bz/events/{id}/lineups |
| 伤停名单 | GET | /v1/bz/events/{id}/injuries |
| 多公司赔率 | GET | /v1/bz/events/{id}/odds |
| 技术统计/xG | GET | /v1/bz/events/{id}/stats |
| 资金占比 | GET | /v1/wom/events/{id} |
| 球队近10场 | GET | /v1/teams/{team}/form |
| 我的额度 | GET | /v1/me |
完整参数见 接口文档（OpenAPI）。
返回 401「API Key 无效」：Key 填错或已过期。检查是否有 bf_ 前缀、有没有多空格。
返回 429：当天次数用完或请求太快。看 /v1/me 查剩余额度。
字段是 null：这场比赛该数据源没有，接口会如实返回 null 并标注，不会编造。
怎么知道哪些比赛有数据：列表里 sources 字段写着来源，has_odds 表示有没有盘口。