SuperAPI AI 工具集

api-football-v3

编程与开发

查看项目

更新于 10-16 05:44

技能介绍

用途:本资料是消费 API-Football v3(api-sports.io)的开发指南,帮助开发者在应用中集成足球赛事数据。

主要能力:覆盖 38 个端点,包括时区、国家、联赛与赛季、球队与场馆、积分榜、赛程(含实时与已结束比赛)、轮次、交锋记录、比赛统计、事件、首发阵容、球员数据、伤病、预测、教练、球员赛季统计与榜单(射手、助攻、黄红牌)、转会、奖杯、停赛、赛前与滚球赔率、赔率映射与博彩公司等。资料还提供 Widgets v3.1 可嵌入组件(比赛列表、比赛详情、积分榜、球队、球员、联赛赛程、联赛浏览、交锋),支持内置与自定义主题、多语言与动态跳转。

使用方式:基础地址为 https://v3.football.api-sports.io/{endpoint},仅支持 GET,认证仅用请求头 x-apisports-key: YOUR_API_KEY,不要附加 Content-Type 等其他头,否则会被拒绝。示例:fetch(${BASE}/fixtures?live=all, { headers: { "x-apisports-key": API_KEY } })。媒体资源(队徽、球员照片、联赛标志、国旗)不计入每日配额;/players、/odds、/players/profiles 等分页每页 20 条。

限制与注意:支持 CORS,但建议经后端代理以隐藏密钥,不要把密钥暴露到浏览器。响应头含每日与每分钟限流信息;免费版每日 100 次、每分钟 30 次,Pro 每日无限、每分钟 300 次,Ultra 450,Mega 600;超速可能被防火墙临时或永久封禁。建议用缓存与后台定时同步,避免在 HTTP 请求处理器内直接轮询;GET /status 不计入配额。资料提及 Widgets 密钥会暴露在 HTML 源码中,需在仪表板限制域名/IP。费用、价格与具体订阅细则暂未提供。