注册账号
使用邮箱创建门户账号，登录状态由安全 Cookie 保存。
私有足球数据 API
一个受控 Key，
连接完整比赛数据。
统一调用即时比分、比赛事件、技术统计、多公司赔率、历史变盘和足球资料库。 注册后即可生成有额度限制的专属 API Key，无需等待人工审批。
统一 JSON额度可见调用可追踪
GETTING STARTED
从注册到首次调用，只需三步
立即生成 Key
无需申请或审核。Key 生成成功后仅完整显示一次。
调用并查看用量
在请求头携带 Key；门户实时汇总月额度和最近调用记录。
API REFERENCE
中文接口文档
生产 API 地址：https://venti-obb-api.tailf3d035.ts.net，所有 /v1 请求均需认证。
认证与快速开始
将领取的 Key 放入 X-API-Key 请求头。不要把 Key 写进公开的前端代码或仓库。
curl "https://venti-obb-api.tailf3d035.ts.net/v1/matches?phase=live" \
-H "X-API-Key: tn_live_xxxxxxxx_xxxxxxxxxxxx"响应头会返回分钟和月度配额：X-RateLimit-Remaining、X-Monthly-Quota-Remaining。
比赛与即时数据
GET
/v1/matches比赛列表；支持 phase、league、q、日期和分页GET
/v1/matches/{match_id}单场比赛、比分与状态GET
/v1/matches/{match_id}/monitor比分、红牌、四类核心盘口与技术统计聚合GET
/v1/matches/{match_id}/events进球、红黄牌、换人等比赛事件GET
/v1/matches/{match_id}/statistics角球、射门、射正、控球率、进攻等统计GET
/v1/matches/{match_id}/lineup首发、替补与阵型GET
/v1/streamSSE 增量事件流；支持 match_id 过滤赔率与变盘
GET
/v1/matches/{match_id}/odds当前核心盘口GET
/v1/matches/{match_id}/odds/history核心盘口历史快照，可按 market 过滤GET
/v1/matches/{match_id}/odds/complete多公司亚盘、大小球、欧赔与角球盘GET
/v1/matches/{match_id}/odds/complete/history多公司完整变盘历史GET
/v1/matches/{match_id}/odds/coverage盘口、公司和时间覆盖情况GET
/v1/bookmakers公司标准化目录GET
/v1/odds/changes按游标读取赔率增量历史资料库
GET
/v1/catalog/countries国家与地区GET
/v1/catalog/competitions联赛和杯赛；支持国家、类型过滤GET
/v1/catalog/competitions/{id}/seasons赛事赛季GET
/v1/catalog/competitions/{id}/seasons/{season}/matches历史赛程与赛果GET
/v1/catalog/competitions/{id}/seasons/{season}/standings积分榜GET
/v1/catalog/teams球队查询与分页GET
/v1/catalog/players球员查询与分页完整字段和可交互调试请访问 OpenAPI 文档 ↗。
状态码与访问限制
200请求成功
401Key 缺失或无效
403Key 已暂停或撤销
404资源不存在
429分钟频率或月额度已用尽
503数据暂不可用
客户端应尊重 Retry-After，使用指数退避；不要并发重试。门户显示的是服务端已记录用量。