DOCS
足球 API赛事

足球赛事列表

调试凭证使用你的 API key

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

GET
/v1/soccer/competitions

鉴权

APIKeyHeader
headerX-API-Key<token>

合作方 API key

查询参数

country?|

按国家 / 地区筛选:代码(ENG)或中文名(英格兰),不区分大小写

type?|

league / cup

search?|

按名称模糊搜索(中英文、繁体的全名与简称)。搜索词至少 2 个字时结果按相关度排序:先完全匹配,再开头或姓名段匹配(如「詹姆斯」之于「勒布朗·詹姆斯」),最后是其余包含该词的;同档内保持列表原有顺序

seasons?Seasons

每个赛事返回最近几个赛季

范围0 <= value <= 50
默认值5
updated_since?|

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

limit?Limit

每页条数,最大 200

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

起始偏移

范围0 <= value
默认值0

响应体

Successful Response

application/json
  1. response
data*array<>

本页数据

pagination*

分页信息