您需要一个 API 来列出您被允许读取的文件,验证目标文件是否存在,然后在不猜测名称或路径的情况下将其提取。到本文结束时,您将调用一个真实的“列出文件”端点,解析其响应,并提取它返回的其中一个文件——干净地,使用您可以在本周投入生产的缓存语义。
此 API 的功能
Zyla API Hub 上的 Fonbet Odds API 提供面向文件的访问,以获取博彩公司赔率快照。它提供:
- 一个文件列表端点,返回您的订阅可以读取的确切赔率文件集,按名称排序。您首先调用此端点,并仅使用它提供的名称。
- 一个提取其中一个文件的端点,以带有元数据和博彩公司原始 JSON 的信封返回。
这完全是一个文件管理工作流程:发现可用文件,通过名称选择一个并下载。它适合于简化摄取作业,在调度提取之前验证访问,并保持您的赔率管道的弹性。
在 Zyla API Hub 上开始
打开 Fonbet Odds API 的 API 页面,点击订阅或开始免费试用(如果可用),并获取您的 API 密钥。身份验证是您添加到请求中的单个头。Zyla API Hub 使用订阅 + 配额模型(而不是按调用付费)。您帐户上的第一个 API 可能提供 7 天的试用或 50 次请求;始终检查 API 页面以获取当前访问选项和定价。
您可以在 Zyla API Hub 上浏览数千个生产就绪的 API,所有这些都在一个帐户和一个 API 密钥下。当您准备好测试这个特定的 API 时,请使用下面的列表链接。
您将使用的端点
基础:所有调用都发送到下面显示的 Zyla Hub URL。除非有文档说明,否则请勿添加查询参数。身份验证需要通过 Authorization: Bearer YOUR_API_KEY。
1) 列出文件
- 方法:GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
- 描述:列出您的订阅可以读取的赔率文件,按名称排序。返回公司、计数和文件(文件名数组)。首先调用它,仅请求它返回的名称。
- 参数:无文档说明。
cURL(可复制/粘贴):
curl -s -X GET "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files"
-H "Authorization: Bearer YOUR_API_KEY"
官方示例响应:
{
"company": "fonbet",
"count": 1,
"files": [
"site_livepre_fonbet.json"
]
}
您实际使用的内容:
- company:标识数据提供者的字符串(在此为“fonbet”)。
- count:您当前订阅可以访问的文件数量。
- files:文件名数组。这些是您应尝试提取的唯一有效输入。
2) 获取数据
- 方法:GET
- URL: https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
- 描述:返回一个赔率文件,包含在一个信封中:{"company", "file", "updated_at", "data"}。数据字段包含博彩公司自己的 JSON,未修改。updated_at 是最后的刷新时间(UTC)。相同的时间通过 Last-Modified 头提供;通过 If-Modified-Since 发送回来,以便在没有更改时接收 304。
- 参数:无文档说明。
cURL:
示例响应(信封中包含原始赔率 JSON 的数据):
生产使用的关键点:
- updated_at 是 UTC。将其视为您检查过期的标准时钟。
- 使用 HTTP 缓存头:在每次成功的 GET 请求中,读取 Last-Modified;在后续请求中将其作为 If-Modified-Since 发送回来,以避免在数据未更改时进行不必要的下载。
- 数据下的博彩公司 JSON 是未修改的;形状可能很大且嵌套,因此仅解析您需要的内容。
端到端示例:发现并提取一个文件
工作流程大纲:
- 调用列出文件以发现允许的文件名。
- 从 files[] 中选择您需要的文件。
- 调用获取数据以检索包含原始赔率 JSON 的信封。
- 存储 updated_at 和 Last-Modified 头以备将来的条件请求。
Python 示例
此脚本列出文件,选择第一个文件名,提取它并打印基本元数据。它还演示了读取 Last-Modified 以便稍后连接条件请求。
import os
import sys
import requests
API_KEY = os.environ.get("ZYLALABS_API_KEY", "YOUR_API_KEY")
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
LIST_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files"
GET_URL = "https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data"
def list_files():
r = requests.get(LIST_URL, headers=HEADERS, timeout=30)
r.raise_for_status()
return r.json()
def get_data(if_modified_since=None):
headers = HEADERS.copy()
if if_modified_since:
headers["If-Modified-Since"] = if_modified_since
r = requests.get(GET_URL, headers=headers, timeout=60)
if r.status_code == 304:
return {"status": 304, "last_modified": if_modified_since, "body": None}
r.raise_for_status()
return {
"status": r.status_code,
"last_modified": r.headers.get("Last-Modified"),
"body": r.json()
}
def main():
listing = list_files()
print(f"公司: {listing.get('company')}")
print(f"文件数量: {listing.get('count')}")
files = listing.get("files", [])
if not files:
print("此订阅没有可用文件。")
sys.exit(0)
target = files[0]
print(f"提取: {target} 通过获取数据端点")
# 首次提取
result = get_data()
print(f"HTTP: {result['status']}, Last-Modified: {result['last_modified']}")
if result["body"]:
env = result["body"]
print(f"信封: company={env.get('company')}, file={env.get('file')}, updated_at={env.get('updated_at')}")
# 原始博彩公司 JSON 在 env['data'];在生产中避免打印巨大的有效负载。
# 使用 Last-Modified 的示例条件请求
if result["last_modified"]:
result2 = get_data(if_modified_since=result["last_modified"])
print(f"条件提取 -> HTTP: {result2['status']} (304 表示未更改)")
if __name__ == "__main__":
main()
注意:
- 列出文件端点未记录请求参数——请勿添加任何。
- 获取数据端点也未记录参数;它将在其标准信封中返回允许的文件。
- 使用适合您环境的超时,并记录 Last-Modified 以进行增量运行。
节省时间的实用集成细节
- 身份验证:始终发送 Authorization: Bearer YOUR_API_KEY。
- 文件名:将 List Files 中的 files[] 视为真实来源。不要在 API 返回的内容之外硬编码名称。
- 排序:列表按名称排序。如果您只期望一个,请断言 count == 1,以便在您的订阅更改时快速失败。
- 时间戳:updated_at 是 ISO 8601 UTC 字符串(例如,2026-09-27T18:24:34Z)。将其与您的摄取批次一起存储以进行审计。
- 缓存:尊重 Last-Modified/If-Modified-Since,以最小化带宽和处理。304 表示您可以重用上一个快照。
- 分页:在列出文件中未记录;代码时假设列表适合一页。如果您的订阅增长,请重新检查 API 页面上的文档。
- 数据量:数据是博彩公司原始的 JSON。它可能很大;流式传输到磁盘或选择性解析。
- 错误处理:处理 401/403 以应对身份验证/订阅问题,以及 304 以应对缓存命中。非 200 响应应有意识地重试。
- 环境:将 API 密钥保留在源控制之外。参数化超时和回退。
- 部署:在启动时或按计划运行列出文件,以在提取之前检测可访问文件的更改。
现实世界的用例
- ETL 启动:使用列出文件在作业开始时验证访问,提取一个实时文件,将 updated_at 和 Last-Modified 附加到您的作业元数据中,并将解析的赔率推送到您的存储中。
- 增量同步:定时调用获取数据,使用 If-Modified-Since。如果 304,则跳过;如果 200,则根据 updated_at 处理最小差异。
- 访问监控:当列出文件的计数或文件名发生变化时发出警报(例如,您的计划中添加/删除了一个文件)。
- 缓存预热:在部署期间使用列出文件预提取目标,然后获取数据以在用户流量之前加热缓存。
通过 MCP 从 AI 代理调用
Zyla 上的每个 API 都可以通过 MCP 端点被 AI 代理调用。将您的 MCP 兼容客户端(例如,Claude Code、Cursor、Windsurf)指向 MCP 网关,并传递您的 Zyla API 密钥。然后,您的代理可以使用相同的 Authorization 头调用上面显示的相同 Hub URL。
文档和端点:MCP
代理内部的典型流程:
- 工具步骤 1:使用您的 Authorization 头 GET 列出文件 URL;解析 files[]。
- 工具步骤 2:GET 获取数据 URL;如果 Last-Modified 存在,则缓存并通过 If-Modified-Since 重用。
如果您的团队通过 Zyla 管理多个 API,MCP 将访问集中在一个密钥和一个集成层下。您可以在 Zyla API Hub 上探索更多选项。
可复制的参考
列出文件
GET https://zylalabs.com/api/13783/fonbet-odds-api/31607/list-files
头:
- Authorization: Bearer YOUR_API_KEY
返回公司、计数、files[]。
获取数据
GET https://zylalabs.com/api/13783/fonbet-odds-api/31608/get-data
头:
- Authorization: Bearer YOUR_API_KEY
- If-Modified-Since: {来自先前 200 的 Last-Modified}(可选,用于缓存)
返回公司、文件、updated_at(UTC)和数据(原始博彩公司 JSON)。发送 Last-Modified 头;如果您提供 If-Modified-Since,则在未更改时返回 304。
常见问题
问:我如何知道我被允许提取哪些文件名?
答:调用列出文件端点。仅请求在文件数组中找到的名称。
问:updated_at 是哪个时区?
答:UTC(例如,2026-09-27T18:24:34Z)。用于审计和过期检查。
问:如果没有更改,我可以避免重新下载文件吗?
答:可以。读取 200 响应中的 Last-Modified 头,并通过 If-Modified-Since 发送回来。当文件未更改时,您将收到 HTTP 304。
问:是否有查询参数可以过滤文件列表或数据?
答:这些端点未记录任何参数。将列表视为完整,将数据视为完整的未修改 JSON。
问:计费是如何处理的?
答:Zyla 使用订阅 + 配额(而不是按调用付费)。第一个 API 可能提供 7 天的试用或 50 次请求。检查 API 页面以获取当前访问选项和定价。
准备好实现您的“先列出然后提取”文件工作流程了吗?从官方列表开始并获取您的密钥:开始 7 天试用 Fonbet Odds API。一个帐户和一个 API 密钥解锁对 Zyla 上超过 10,000 个公共 API 的访问。