华体会官方赛事数据API接口与技术文档
欢迎使用华体会官方赛事数据API。本接口为开发者提供稳定、高效的全球体育赛事数据服务，涵盖实时比分、赛程赛果、球队/球员统计、联赛积分榜等核心数据。以下文档将帮助您快速集成与调用。
⚡
毫秒级响应
全球CDN加速，数据延迟低于50ms，保障实时性。
📊
覆盖30+联赛
英超、西甲、NBA、CBA、欧冠等主流赛事全覆盖。
🔐
安全稳定
基于HTTPS加密与Token鉴权，99.9% SLA保障。
1. 接口基础信息
Base URL
https://api.hthwangyeban.com/v1
认证方式
所有请求需在Header中携带API Key：X-API-Key: your_api_key_here
数据格式
请求与响应均采用 application/json 格式。
速率限制
免费套餐：每分钟60次请求；付费套餐：每分钟600次请求。超出限制返回HTTP 429。
2. 核心接口列表
获取实时比分
GET
/matches/live
返回当前正在进行的比赛列表及实时比分、比赛时间、状态等数据。
请求示例：
curl -H "X-API-Key: your_api_key" \
https://api.hthwangyeban.com/v1/matches/live?league=all响应示例：
{
"status": "ok",
"data": [
{
"match_id": "12345",
"league": "英超",
"home_team": "曼城",
"away_team": "利物浦",
"home_score": 2,
"away_score": 1,
"minute": 67,
"status": "live"
}
]
}查询赛程与赛果
GET
/matches/schedule
按联赛、日期范围查询赛程及历史赛果，支持分页。
请求参数：
{
"league": "英超",
"date_from": "2025-04-01",
"date_to": "2025-04-07",
"page": 1,
"per_page": 20
}球队赛季数据
GET
/teams/{team_id}/stats
获取指定球队在当前赛季的完整统计数据，包括进球、失球、控球率、射门次数等。
路径参数：
team_id: 球队唯一标识（如 "man-city"）联赛积分榜
GET
/standings/{league}
返回指定联赛的当前积分排名，包含胜平负、净胜球、积分等字段。
请求示例：
curl -H "X-API-Key: your_api_key" \
https://api.hthwangyeban.com/v1/standings/英超3. 错误码说明
| 状态码 | 含义 | 说明 |
|---|---|---|
| 200 | 成功 | 请求成功，返回数据。 |
| 400 | 参数错误 | 请求参数缺失或格式不正确。 |
| 401 | 未授权 | API Key无效或未提供。 |
| 429 | 请求过多 | 超出速率限制，请稍后重试。 |
| 500 | 服务器错误 | 内部服务异常，请联系技术支持。 |
4. SDK与代码示例
JavaScript (Node.js)
const axios = require('axios');
const api = axios.create({
baseURL: 'https://api.hthwangyeban.com/v1',
headers: { 'X-API-Key': 'your_api_key' }
});
async function getLiveScores() {
const res = await api.get('/matches/live');
console.log(res.data);
}Python
import requests
headers = {'X-API-Key': 'your_api_key'}
url = 'https://api.hthwangyeban.com/v1/matches/live'
response = requests.get(url, headers=headers)
data = response.json()
print(data)Java (OkHttp)
OkHttpClient client = new OkHttpClient();
Request request = new Request.Builder()
.url("https://api.hthwangyeban.com/v1/matches/live")
.addHeader("X-API-Key", "your_api_key")
.build();
Response response = client.newCall(request).execute();cURL
curl -H "X-API-Key: your_api_key" \
https://api.hthwangyeban.com/v1/matches/live?league=英超需要帮助？
查阅完整技术文档或获取API Key，请访问华体会官方开发者中心。我们提供7x24小时技术支持。