首页 » 博客 » API调用详解

API接口调用详解：认证方式、请求参数与返回格式说明

2026-05-12 · 技术文档 · esportsapi.cn

接口认证方式

所有 体育数据接口 采用 HTTP Header 方式进行认证。你需要在每个请求的 Header 中携带你的 API Key：

X-API-Key: your_api_key_here

请务必通过 HTTPS 协议访问，确保 API Key 在传输过程中加密。

基础URL

所有接口的基础地址为：

https://esportsapi.cn/v1

常用接口一览

接口路径	功能	方法
`/football/matches`	获取足球比赛列表	GET
`/football/standings`	获取联赛积分榜	GET
`/football/teams`	获取队伍信息与统计	GET
`/basketball/matches`	获取篮球比赛列表	GET
`/basketball/standings`	获取篮球联赛积分榜	GET
`/esports/matches`	获取电竞比赛列表	GET

查询参数说明

以 足球数据接口 为例，常用的查询参数包括：

league — 联赛代码，如 eng.1（英超）、esp.1（西甲）
days — 查询最近N天的比赛
date — 指定日期，格式 YYYY-MM-DD
limit — 返回结果数量上限
page — 分页页码

返回数据格式

所有接口统一返回 JSON 格式数据：

{
  "code": 200,
  "message": "success",
  "data": {
    "matches": [...],
    "total": 10,
    "page": 1
  }
}

多语言示例

JavaScript (Node.js)

const resp = await fetch("https://esportsapi.cn/v1/football/matches?league=eng.1&days=7", {
  headers: { "X-API-Key": "your_api_key" }
});
const data = await resp.json();

cURL

curl -H "X-API-Key: your_api_key" \
  "https://esportsapi.cn/v1/football/matches?league=eng.1&days=7"