Ligue 1

Ligue 1 standings, fixtures, results, live scores, lineups, events, player and team stats. Current season plus history.

原始信息汇总

数据集概述：Ligue 1 API

本数据集提供法国足球甲级联赛（Ligue 1）的全方位数据接口，涵盖赛季积分榜、赛程与结果、实时比分、阵容、比赛事件、球员与球队统计等信息。数据覆盖当前赛季及两个完整历史赛季，每个新赛季会自动归档。

核心功能与数据内容

• 积分榜 (/standings)：提供联赛积分表，包含已赛场次、胜/平/负场次、进球、失球、积分、近期状态（form）及资格赛区域划分。
• 比赛数据 (/matches系列)：
  • 赛程与结果，支持按轮次、日期、状态、球队等条件筛选。
  • 单场详细信息，包括首发阵容与阵型、每位球员的出场时间、评分与技术统计、进球、红黄牌、换人、裁判和比赛场地。比赛详情可通过比赛ID获取。
  • 实时比赛数据（/matches/live），每30秒更新一次，覆盖比分、比赛分钟、阵容和事件，直到终场哨响；完赛比赛在结束后10分钟会再次获取最终统计数据。
  • 当日比赛 (/matches/today，按UTC时间) 和下一轮比赛 (/matches/next)。
• 球队数据 (/teams系列)：
  • 球队列表及获取单支球队的详细信息（包含教练和球队颜色）。
  • 球队阵容，含球员位置、球衣号码、年龄、身高、国籍。
  • 球队的比赛记录、赛季总统计（含零封场次和红黄牌数）以及两支球队之间的历史交锋记录（覆盖所有存储的赛季）。
• 球员数据 (/players系列)：
  • 球员列表，支持按球队、位置、国籍筛选。
  • 球员详细信息及赛季统计，以及球员逐场比赛的出场时间、进球、助攻和评分。
• 联赛统计 (/stats系列)：提供最佳射手、助攻王、红黄牌榜以及平均评分榜（至少出场5次）的排名数据。
• 竞赛概览 (GET /)：返回竞赛信息、当前赛季和可用赛季列表。

技术规范与使用约定

• 响应格式：所有成功响应均为 { "data": ..., "meta": ... } 格式；错误响应为 { "error": { "code": ..., "message": ... } }。
• 时间戳：统一使用UTC ISO 8601格式。
• 赛季参数：赛季限定接口接受 ?season=2025-26 参数，默认为当前赛季。
• 分页：列表接口支持 page 和 limit 参数，limit 默认值为50，最大为200；meta 中会返回 page、limit 和 total。
• 比赛状态：比赛状态字段为 scheduled、live、halftime、finished、postponed 或 cancelled 之一。
• 球队标识：球队可以使用稳定的数字ID，也可使用别名（slug），例如 /teams/paris-saint-germain。

数据接口列表

路径	返回内容
GET /	竞赛信息、当前赛季及可用赛季
GET /standings	积分榜详情（含资格区）
GET /teams	本赛季球队列表
GET /teams/{id}	球队详情（含教练和颜色）
GET /teams/{id}/squad	球队阵容详情
GET /teams/{id}/matches	该球队的比赛记录
GET /teams/{id}/stats	球队赛季总统计（含零封和红黄牌）
GET /teams/{id}/head-to-head/{otherId}	两队在历史赛季的交锋记录
GET /players	球员列表（可筛选）
GET /players/{id}	球员详情及赛季统计
GET /players/{id}/matches	球员逐场比赛统计
GET /matches	赛程与结果（可筛选）
GET /matches/{id}	单场比赛完整详情(阵容、事件等)
GET /matches/live	进行中的比赛实时数据
GET /matches/today	今日比赛（UTC时间）
GET /matches/next	下一轮比赛
GET /stats/top-scorers	射手榜（支持limit参数，最大100）
GET /stats/top-assists	助攻榜
GET /stats/cards	红黄牌榜
GET /stats/ratings	平均评分榜（最少出场5次）