GET/api/v1/contests
本页目录
本接口返回比赛列表。
参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
track | string | 否 | 赛道 slug；比赛属于多个赛道时，任一赛道命中即可 |
city | string | 否 | 城市（线下赛） |
online | string | 否 | 是否只看线上赛，填 true 或 false；可选值：true / false |
status | string | 否 | 比赛状态；不传时默认只返回「可报名」（open / closing）；可选值：open / closing / live / ended |
deadlineBefore | string | 否 | 报名截止不晚于该日期（YYYY-MM-DD，按 Asia/Shanghai） |
minPrize | number | 否 | 总奖金不低于（元） |
emerging | string | 否 | 是否只看新兴赛道，填 true 或 false；可选值：true / false |
q | string | 否 | 关键词，匹配标题与简介 |
page | integer | 否 | 页码，从 1 开始 |
pageSize | integer | 否 | 每页条数，默认 20，最大 100 |
请求示例
所有接口匿名可用，按 IP 限流 60 次/分钟；需要提高额度时，可在请求头带 X-API-Key。
bash
curl "https://tiangongkaiwuai.cn/api/v1/contests?track=da-mo-xing&city=%E6%9D%AD%E5%B7%9E&online=true&status=closing&deadlineBefore=2026-12-31&minPrize=100000&emerging=true&q=%E5%A4%A7%E6%A8%A1%E5%9E%8B&page=1&pageSize=20"错误
| 状态码 | 含义 |
|---|---|
| 400 | 查询参数不合法 |
| 429 | 请求过于频繁（带 X-API-Key 可提额） |
更新于 2026-10-29来源：由 openapi.json 自动生成，请勿手改