📚 API 文档
SportFlv 体育数据API接口文档
🔐 认证方式
所有API请求需在请求头中携带API Token（使用标准OAuth2 Bearer格式）：
Authorization: Bearer <your-token>
⚽ 获取比赛列表
接口地址
GET /api/matches请求参数
| 参数名 | 类型 | 必需 | 说明 |
|---|---|---|---|
| date | string | 否 | 比赛日期，格式YYYY-MM-DD |
| sportId | integer | 否 | 运动类型，1=足球，2=篮球，3=电竞 |
| status | integer | 否 | 比赛状态，1=进行中，2=已结束 |
请求示例
# 获取今日所有比赛
GET /api/matches?date=2025-11-28
# 获取进行中的足球比赛
GET /api/matches?sportId=1&status=1
返回格式
{
"success": true,
"data": {
"matches": [
{
"match_id": 12345,
"sport_id": 1,
"home_team_name": "Arsenal",
"away_team_name": "Chelsea",
"home_score": 2,
"away_score": 1,
"match_time": "2025-11-28T20:00:00Z",
"status_description": "live",
"league_name": "英超",
"video_count": 3
}
],
"total": 50
}
}💻 代码示例
JavaScript
const response = await fetch('/api/matches?date=2025-11-28', {
headers: {
'Authorization': 'Bearer YOUR_TOKEN'
}
});
const data = await response.json();
console.log(data.data.matches);Python
import requests
response = requests.get(
'https://sportflv.com/api/matches',
params={'date': '2025-11-28'},
headers={'Authorization': 'Bearer YOUR_TOKEN'}
)
data = response.json()
print(data['data']['matches'])⚡ 速率限制
| Token类型 | 前缀 | 每分钟限制 | 每日限制 |
|---|---|---|---|
| 测试Token | sk_test_ | 30次 | 1,000次 |
| 用户Token | sk_user_ | 300次 | 10,000次 |
| 管理员Token | sk_admin_ | 1,000次 | 50,000次 |
❓ 常见问题
Q: 如何获取API Token？
A: 请联系管理员获取API Token，测试用途可申请 sk_test_ 前缀Token。
Q: 直播源字段有什么区别？
A: streams 是传统直播流，videos 是高质量视频源（推荐），push_urls 是RTMP推流地址。
Q: 如何判断比赛状态？
A: 使用 status_description 字段，值为 scheduled/live/finished。