DOCS
篮球 API比赛

篮球比赛列表

调试凭证使用你的 API key

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

GET
/v1/basketball/matches

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

competition_id?array<string>|

赛事对外 ID,跨该赛事的全部赛季;可重复传,最多 50 个

season_id?|

赛季对外 ID

stage_id?|

阶段对外 ID

series_id?|

系列赛对外 ID

team_id?|

球队对外 ID,主场或客场

opponent_id?|

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

date_from?|

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

date_to?|

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

status?|

语义状态

updated_since?|

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

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*

分页信息