调用信息
- 请求
GET https://api.sports.csap.ai/api/v1/standing- 鉴权
- 请求头 X-API-Key: <你的 key>(也支持 Authorization: Bearer <key>;?key= 仍可用但不建议,key 会留在地址和日志里)
- 外部 key
- 可调用(数据有范围)外部 key 可以调用,但只返回开放范围内的数据,见「通用说明 · 外部 key 的数据范围」。
- 频率限制
- 每分钟 3000 次 · 每天 200000 次 · 按 key 配置(以 /api/v1/account 返回的 rate_per_min、quota_daily 为准;上面是试用 key 的值),超出回 429。另外整表快照、不带比赛 id 的统计列表等重型请求全站同时只处理 2 个,排不上回 429 + Retry-After。响应里暂时没有 X-RateLimit-* 头。 详见通用说明
请求参数 3
| 参数 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|
| gcid | integer | 可选 | 287 | 我方赛事 id |
| gtid | integer | 可选 | 14143 | 只看某支球队 |
| limit | integer | 可选 | 2 | 返回条数 |
请求示例
curl "https://api.sports.csap.ai/api/v1/standing?limit=2" \ -H "X-API-Key: YOUR_API_KEY"
在线调试
示例返回
{
"code": 0,
"data": [
{
"away_draws": 1,
"away_goals_against": 8,
"away_goals_for": 17,
"away_losses": 1,
"away_played": 8,
"away_points": 19,
"away_rank": 1,
"away_wins": 6,
"draws": 2,
"gcid": 46,
"goal_diff": 18,
"goals_against": 12,
"goals_for": 30,
"grp": null,
"gtid": null,
"home_draws": 1,
"home_goals_against": 4,
"home_goals_for": 13,
"home_losses": 1,
"home_played": 6,
"home_points": 13,
"home_rank": 5,
"home_wins": 4,
"league": "1. Lig",
"logo": null,
"losses": 2,
"name_zh": null,
"played": 14,
"points": 32,
"rank": 1,
"season_id": "98149",
"source": "S2",
"updated_at": "2026-11-09T01:17:00.672346Z",
"wins": 10
},
{
"away_draws": 2,
"away_goals_against": 5,
"away_goals_for": 15,
"away_losses": 1,
"away_played": 8,
"away_points": 17,
"away_rank": 2,
"away_wins": 5,
"draws": 3,
"gcid": 46,
"goal_diff": 22,
"goals_against": 11,
"goals_for": 33,
"grp": null,
"gtid": 357,
"home_draws": 1,
"home_goals_against": 6,
"home_goals_for": 18,
"home_losses": 1,
"home_played": 6,
"home_points": 13,
"home_rank": 4,
"home_wins": 4,
"league": "1. Lig",
"logo": "http://43.99.60.51:8080/logos/4c6955a0de305b1e552b42f031fac48e5144e02225faa4e416003000a9f84077.png",
"losses": 2,
"name_zh": "开塞利体育",
"played": 14,
"points": 30,
"rank": 2,
"season_id": "98149",
"source": "S2",
"updated_at": "2026-11-09T01:17:00.673515Z",
"wins": 9
}
],
"message": "success",
"success": true
}返回字段 35
away_drawsinteger客场平
示例: 1away_goals_againstinteger
示例: 8away_goals_forinteger客场进球
示例: 17away_lossesinteger客场负
示例: 1away_playedinteger客场已赛
示例: 8away_pointsinteger
示例: 19away_rankinteger客场排名
示例: 1away_winsinteger客场胜
示例: 6drawsinteger平局数
示例: 2gcidinteger我方赛事 id
示例: 46goal_diffinteger净胜球
示例: 18goals_againstinteger失球
示例: 12goals_forinteger进球
示例: 30grpnull可为空分组
gtidinteger可为空我方球队 id
示例: 357home_drawsinteger主场平
示例: 1home_goals_againstinteger
示例: 4home_goals_forinteger主场进球
示例: 13home_lossesinteger主场负
示例: 1home_playedinteger主场已赛
示例: 6home_pointsinteger
示例: 13home_rankinteger主场排名
示例: 5home_winsinteger主场胜
示例: 4leaguestring赛事名(英文)
示例: "1. Lig"logostring可为空logo(本平台的图片地址;没有时为空)
lossesinteger负场数
示例: 2name_enstring英文名
示例: "Bursaspor"name_zhstring可为空中文名
示例: "开塞利体育"playedinteger已赛场次
示例: 14pointsinteger积分
示例: 32rankinteger排名
示例: 1season_idstring赛季 id
示例: "98149"sourcestring数据来源代号(S1、S2…)
示例: "S2"updated_atstring最后更新时间(UTC,ISO 8601;增量同步用 time 参数按它取)
示例: "2026-11-09T01:17:00.672346Z"winsinteger胜场数
示例: 10错误码
| HTTP | message | 场景 |
|---|---|---|
| 401 | missing API key / unauthorized | 没带 X-API-Key 或 key 无效、已停用 |
| 429 | rate limit exceeded / daily quota exceeded | 超过 key 的每分钟次数或每日配额 |
| 429 | server busy, retry later | 服务端并发名额已满(重型请求同时只有 2 个),按 Retry-After 秒后重试 |
| 500 | query error | 服务端查询失败,可重试 |