DOCS
足球 API比赛

足球比赛列表

调试凭证使用你的 API key

仅在本页使用,刷新后清除。在线调试会使用你的调用额度。

GET
/v1/soccer/matches

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

competition_id?array<string>|

赛事对外 ID,可重复传,最多 50 个

season_id?|

赛季对外 ID(子赛季归到同名主赛季)

stage_id?|

阶段对外 ID

group_id?|

小组对外 ID

team_id?|

球队对外 ID,主场或客场

opponent_id?|

对手球队对外 ID:只返回 team_id 与它之间的比赛(不分主客)。必须同时给 team_id

round?|

轮次

date_from?|

开赛日期下限(含),按北京时间的日期

date_to?|

开赛日期上限(含),按北京时间的日期

status?|

语义状态

updated_since?|

只返回此时间之后更新过的场次(含),ISO 8601,可带任意时区偏移;不带偏移按 +08:00

include?array<>

可选子数据:events 事件、lineups 阵容、stats 黄牌 / 红牌 / 角球(可重复传)

默认值[]
order?Order

按开赛时间排序方向:asc 升序 / desc 降序

默认值"asc"
可选值"asc""desc"
limit?Limit

每页条数,最大 200

范围1 <= value <= 200
默认值50
offset?Offset

起始偏移

范围0 <= value
默认值0

响应体

Successful Response

application/json
  1. response
data*array<>

本页数据

pagination*

分页信息