{
  "openapi": "3.1.0",
  "info": {
    "title": "iDalgo Business API",
    "version": "0.4.7",
    "description": "API de données sportives en lecture seule : JSON compact dans une enveloppe `{ data, meta, links }`, pagination par curseur, en-têtes de cache sur chaque réponse."
  },
  "components": {
    "schemas": {
      "SportsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Sport"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ApiListMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiListLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "Sport": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un sport"
          },
          "code": {
            "$ref": "#/components/schemas/SportCode"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "code",
          "name"
        ],
        "description": "Un sport : `code` pour le rendu, `id` pour filtrer les autres routes (`?sport=`)"
      },
      "SportCode": {
        "type": "string",
        "minLength": 1,
        "description": "Code stable d'un sport, qui choisit son profil de rendu ; `other` sans profil dédié. Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "football",
          "rugby",
          "basketball",
          "handball",
          "volleyball",
          "other"
        ]
      },
      "ApiListMeta": {
        "type": "object",
        "properties": {
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de génération de la réponse"
          },
          "version": {
            "type": "string",
            "enum": [
              "v1"
            ],
            "description": "Version du contrat de la réponse : `v1` pour une ressource `/v1`, celle du module pour un module (`/modules/<nom>/v<n>` → `v<n>`)"
          },
          "lang": {
            "$ref": "#/components/schemas/Lang"
          },
          "cursor": {
            "type": "string",
            "nullable": true,
            "description": "Curseur à renvoyer en `?cursor=` pour la page suivante ; `null` sur la dernière"
          }
        },
        "required": [
          "generatedAt",
          "version",
          "lang",
          "cursor"
        ],
        "description": "Méta d'une liste paginée par curseur"
      },
      "Lang": {
        "type": "string",
        "enum": [
          "ar",
          "da",
          "de",
          "en",
          "es",
          "fa",
          "fi",
          "fr",
          "it",
          "ja",
          "ko",
          "nl",
          "no",
          "pl",
          "pt",
          "ro",
          "ru",
          "sv",
          "th",
          "tr",
          "zh"
        ],
        "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français."
      },
      "ApiListLinks": {
        "type": "object",
        "properties": {
          "self": {
            "type": "string",
            "description": "Chemin de la ressource, paramètres triés"
          },
          "next": {
            "type": "string",
            "description": "Page suivante ; absent sur la dernière"
          }
        },
        "required": [
          "self"
        ]
      },
      "Problem": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "status": {
            "type": "integer"
          },
          "code": {
            "$ref": "#/components/schemas/ApiErrorCode"
          },
          "detail": {
            "type": "string",
            "description": "Explication propre à cette requête"
          },
          "requestId": {
            "type": "string",
            "description": "Identifiant de la requête (aussi en en-tête `X-Request-Id`) sur une erreur `internal-error`, à donner au support"
          }
        },
        "required": [
          "type",
          "title",
          "status",
          "code"
        ],
        "description": "Erreur au format `application/problem+json` (RFC 9457)"
      },
      "ApiErrorCode": {
        "type": "string",
        "minLength": 1,
        "description": "Code stable d'une erreur de l'API. Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "invalid-request",
          "not-found",
          "internal-error",
          "season-not-found",
          "day-not-found",
          "phase-not-found",
          "team-not-found",
          "person-not-found",
          "contest-not-found",
          "standings-unavailable",
          "medal-table-unavailable",
          "leaders-unavailable",
          "person-stats-unavailable",
          "bracket-unavailable"
        ]
      },
      "CompetitionsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Competition"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ApiListMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiListLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "Competition": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une compétition"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CompetitionLogo"
              },
              {
                "nullable": true
              }
            ]
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "currentSeason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonRef"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "logo",
          "sport",
          "currentSeason"
        ],
        "description": "Une compétition. `currentSeason` est le point d'entrée vers ses classements (`/v1/standings?season=<id>`) ; `null` quand la source n'en désigne pas."
      },
      "CompetitionLogo": {
        "type": "object",
        "properties": {
          "small": {
            "$ref": "#/components/schemas/Image"
          },
          "large": {
            "$ref": "#/components/schemas/Image"
          }
        },
        "required": [
          "small",
          "large"
        ],
        "description": "Logo d'une compétition, en PNG carré : `small` en 32 × 32 px (liste, en-tête de bloc), `large` en 100 × 100 px (fiche). Servi pour les compétitions de football, `null` pour les autres sports. Une compétition dont iDalgo n'a pas le fichier répond 404 à cette adresse : prévoyez un repli (nom seul)"
      },
      "Image": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "format": "uri",
            "description": "Adresse absolue de l'image, servie par le CDN"
          },
          "width": {
            "type": "integer",
            "minimum": 0,
            "description": "Largeur, en pixels"
          },
          "height": {
            "type": "integer",
            "minimum": 0,
            "description": "Hauteur, en pixels"
          }
        },
        "required": [
          "url",
          "width",
          "height"
        ],
        "description": "Une image servie par le CDN des médias iDalgo"
      },
      "SeasonRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une saison de compétition"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name"
        ],
        "description": "Une saison de compétition (« Ligue 1 2026/2027 »)"
      },
      "SeasonResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Season"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "Season": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une saison de compétition"
          },
          "name": {
            "type": "string"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "phases": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Phase"
            }
          }
        },
        "required": [
          "id",
          "name",
          "competition",
          "sport",
          "phases"
        ],
        "description": "Une saison de compétition : point d'entrée qui décrit ses phases avant d'appeler classements ou contests"
      },
      "CompetitionRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une compétition"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CompetitionLogo"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "logo"
        ],
        "description": "Une compétition (Ligue 1, NBA, Jeux olympiques…)"
      },
      "Phase": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une phase"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "order": {
            "type": "integer",
            "nullable": true
          },
          "format": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseFormat"
              },
              {
                "nullable": true
              }
            ]
          },
          "thirdPlace": {
            "type": "boolean",
            "description": "Vrai pour le match de la 3e place (petite finale) : une phase à élimination hors de la progression vers la finale, que ni les demi-finalistes qualifiés ni le tableau ne suivent"
          },
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/GroupRef"
            }
          }
        },
        "required": [
          "id",
          "name",
          "order",
          "format",
          "thirdPlace",
          "groups"
        ],
        "description": "Une phase de la saison et ses poules. `format` vaut `null` quand la source ne permet pas de le déduire."
      },
      "PhaseFormat": {
        "type": "string",
        "minLength": 1,
        "description": "Structure d'une phase, indépendante du sport : championnat, poules, élimination, course, multi-épreuves, circuit. Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "league",
          "groups",
          "knockout",
          "race",
          "multi-event",
          "series"
        ]
      },
      "GroupRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une poule"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name"
        ],
        "description": "Une poule d'une phase"
      },
      "ApiMeta": {
        "type": "object",
        "properties": {
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de génération de la réponse"
          },
          "version": {
            "type": "string",
            "enum": [
              "v1"
            ],
            "description": "Version du contrat de la réponse : `v1` pour une ressource `/v1`, celle du module pour un module (`/modules/<nom>/v<n>` → `v<n>`)"
          },
          "lang": {
            "$ref": "#/components/schemas/Lang"
          }
        },
        "required": [
          "generatedAt",
          "version",
          "lang"
        ],
        "description": "Méta d'une réponse `/v1` ou d'un module"
      },
      "ApiLinks": {
        "type": "object",
        "properties": {
          "self": {
            "type": "string",
            "description": "Chemin de la ressource, paramètres triés"
          }
        },
        "required": [
          "self"
        ]
      },
      "MedalTableResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/MedalTable"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "MedalTable": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "medal-table"
            ]
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "sort": {
            "$ref": "#/components/schemas/MedalSort"
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "gold",
                "silver",
                "bronze",
                "total"
              ]
            },
            "description": "Clés de `stats` à afficher, dans l'ordre"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/MedalTableRow"
            }
          }
        },
        "required": [
          "kind",
          "competition",
          "season",
          "sort",
          "columns",
          "rows"
        ],
        "description": "Tableau des médailles d'une saison (édition des JO, championnat multisport). Les pays à égalité parfaite partagent la même `position`."
      },
      "MedalSort": {
        "type": "string",
        "enum": [
          "gold",
          "total"
        ],
        "description": "Ordre du tableau : à l'or (puis argent, bronze), usage olympique, ou au total"
      },
      "MedalTableRow": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "competitor": {
            "$ref": "#/components/schemas/CountryCompetitor"
          },
          "stats": {
            "$ref": "#/components/schemas/MedalStats"
          }
        },
        "required": [
          "position",
          "competitor",
          "stats"
        ]
      },
      "CountryCompetitor": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un pays"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true,
            "pattern": "^[A-Z]{2,3}$",
            "description": "Code CIO du pays (`FRA`) ; à défaut, son code iDalgo (`VA`)"
          },
          "flag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryFlag"
              },
              {
                "nullable": true
              }
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "country"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "code",
          "flag",
          "type"
        ],
        "description": "Un pays concurrent (tableau des médailles)"
      },
      "CountryFlag": {
        "type": "object",
        "properties": {
          "small": {
            "$ref": "#/components/schemas/Image"
          },
          "svg": {
            "type": "string",
            "format": "uri",
            "description": "Le drapeau en SVG, au format 3:2, net à toute taille"
          }
        },
        "required": [
          "small",
          "svg"
        ],
        "description": "Drapeau d'un pays : `small` en PNG 16 × 11 px, `svg` vectoriel au format 3:2. Un pays dont iDalgo n'a pas le fichier répond 404 à ces adresses : prévoyez un repli"
      },
      "MedalStats": {
        "type": "object",
        "properties": {
          "gold": {
            "type": "integer",
            "minimum": 0
          },
          "silver": {
            "type": "integer",
            "minimum": 0
          },
          "bronze": {
            "type": "integer",
            "minimum": 0
          },
          "total": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "gold",
          "silver",
          "bronze",
          "total"
        ]
      },
      "SeasonLeadersResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/SeasonLeaders"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "SeasonLeaders": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "stat": {
            "$ref": "#/components/schemas/LeaderStat"
          },
          "leaders": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeasonLeader"
            },
            "description": "Du premier au dernier, vide tant qu'aucun match de la saison n'est joué"
          }
        },
        "required": [
          "competition",
          "season",
          "stat",
          "leaders"
        ],
        "description": "Classement des joueurs d'une saison (buteurs, passeurs, cartons), servi seulement pour une saison dont presque tous les matchs joués ont leurs actions"
      },
      "LeaderStat": {
        "type": "string",
        "enum": [
          "goals",
          "assists",
          "yellow-cards",
          "red-cards"
        ],
        "description": "Statistique classée : buts (hors contre son camp et buts refusés), passes décisives, cartons jaunes, cartons rouges (rouge direct ou deuxième jaune)"
      },
      "SeasonLeader": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Rang ; des joueurs à égalité partagent le même"
          },
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "Dernière équipe du joueur dans la saison (un joueur transféré garde la plus récente)"
          },
          "value": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "position",
          "person",
          "team",
          "value"
        ],
        "description": "Un joueur du classement et sa valeur"
      },
      "PersonRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une personne (athlète, arbitre)"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "photo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonPhoto"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "photo"
        ],
        "description": "Une personne : athlète, joueur, arbitre"
      },
      "PersonPhoto": {
        "type": "object",
        "properties": {
          "small": {
            "$ref": "#/components/schemas/Image"
          },
          "large": {
            "$ref": "#/components/schemas/Image"
          }
        },
        "required": [
          "small",
          "large"
        ],
        "description": "Portrait d'une personne, en JPEG au format 5:7 : `small` en 50 × 70 px (liste, composition), `large` en 100 × 141 px (fiche). Beaucoup de personnes n'ont pas de portrait : l'adresse répond alors 404, prévoyez un repli (silhouette neutre)"
      },
      "TeamCompetitor": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "team"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une équipe"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamLogo"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "logo"
        ],
        "description": "Une équipe"
      },
      "TeamLogo": {
        "type": "object",
        "properties": {
          "small": {
            "$ref": "#/components/schemas/Image"
          },
          "large": {
            "$ref": "#/components/schemas/Image"
          }
        },
        "required": [
          "small",
          "large"
        ],
        "description": "Logo d'une équipe, en PNG carré : `small` en 32 × 32 px (liste, tableau), `large` en 100 × 100 px (fiche, en-tête de match). Servi pour les équipes de football, `null` pour les autres sports. Une équipe dont iDalgo n'a pas le fichier répond 404 à cette adresse : prévoyez un repli (écusson neutre)"
      },
      "SeasonListResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeasonSummary"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ],
        "description": "Saisons d'une compétition, de la plus récente à la plus ancienne. Liste bornée : non paginée."
      },
      "SeasonSummary": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une saison de compétition"
          },
          "name": {
            "type": "string"
          },
          "year": {
            "type": "integer",
            "nullable": true,
            "description": "Année de fin de saison"
          },
          "current": {
            "type": "boolean",
            "description": "Saison courante de la compétition"
          }
        },
        "required": [
          "id",
          "name",
          "year",
          "current"
        ],
        "description": "Une saison dans la liste de sa compétition"
      },
      "SeasonDaysResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeasonDay"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ],
        "description": "Journées d'une saison, dans l'ordre chronologique. Liste bornée : non paginée."
      },
      "SeasonDay": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une journée"
          },
          "number": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Rang de la journée dans sa phase (« Journée 20 »)"
          },
          "date": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "contestCount": {
            "type": "integer",
            "minimum": 0
          },
          "finishedCount": {
            "type": "integer",
            "minimum": 0
          },
          "current": {
            "type": "boolean",
            "description": "Dernière journée passée, ou la première si la saison n'a pas commencé"
          }
        },
        "required": [
          "id",
          "number",
          "date",
          "phase",
          "contestCount",
          "finishedCount",
          "current"
        ],
        "description": "Une journée de la saison"
      },
      "PhaseRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une phase"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name"
        ],
        "description": "Une phase de la saison (saison régulière, play-offs…)"
      },
      "StandingsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/Standings"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "Standings": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/LeagueTable"
          },
          {
            "$ref": "#/components/schemas/WinPercentageTable"
          }
        ],
        "discriminator": {
          "propertyName": "kind",
          "mapping": {
            "league-table": "#/components/schemas/LeagueTable",
            "win-percentage": "#/components/schemas/WinPercentageTable"
          }
        },
        "description": "Classement d'une saison ; sa forme dépend de `kind`"
      },
      "LeagueTable": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "league-table"
            ]
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "split": {
            "$ref": "#/components/schemas/StandingSplit"
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "points",
                "played",
                "won",
                "drawn",
                "lost",
                "scored",
                "conceded",
                "difference"
              ]
            },
            "description": "Clés de `stats` à afficher, dans l'ordre"
          },
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeagueTableGroup"
            }
          }
        },
        "required": [
          "kind",
          "sport",
          "competition",
          "season",
          "split",
          "columns",
          "groups"
        ],
        "description": "Classement aux points"
      },
      "StandingSplit": {
        "type": "string",
        "enum": [
          "overall",
          "home",
          "away"
        ],
        "description": "Classement général, à domicile ou à l'extérieur"
      },
      "LeagueTableGroup": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "minLength": 1,
            "description": "Identifiant opaque d'une poule"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "day": {
            "$ref": "#/components/schemas/DayRef"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LeagueTableRow"
            }
          }
        },
        "required": [
          "id",
          "name",
          "day",
          "rows"
        ],
        "description": "Une poule et son classement après `day` ; `id` vaut `null` pour une phase sans poule"
      },
      "DayRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une journée"
          },
          "date": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          }
        },
        "required": [
          "id",
          "date"
        ],
        "description": "Une journée de la saison, et sa date"
      },
      "LeagueTableRow": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "evolution": {
            "type": "integer",
            "nullable": true,
            "description": "Évolution de la place depuis la journée précédente"
          },
          "competitor": {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          "stats": {
            "$ref": "#/components/schemas/LeagueTableStats"
          }
        },
        "required": [
          "position",
          "evolution",
          "competitor",
          "stats"
        ]
      },
      "LeagueTableStats": {
        "type": "object",
        "properties": {
          "points": {
            "type": "number"
          },
          "played": {
            "type": "integer",
            "minimum": 0
          },
          "won": {
            "type": "integer",
            "minimum": 0
          },
          "drawn": {
            "type": "integer",
            "minimum": 0
          },
          "lost": {
            "type": "integer",
            "minimum": 0
          },
          "scored": {
            "type": "integer",
            "minimum": 0
          },
          "conceded": {
            "type": "integer",
            "minimum": 0
          },
          "difference": {
            "type": "integer"
          }
        },
        "required": [
          "points",
          "played",
          "won",
          "drawn",
          "lost",
          "scored",
          "conceded",
          "difference"
        ],
        "description": "Classement aux points (football, rugby, handball…). `scored` / `conceded` : buts ou points selon le sport."
      },
      "WinPercentageTable": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "win-percentage"
            ]
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "split": {
            "$ref": "#/components/schemas/StandingSplit"
          },
          "columns": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "played",
                "won",
                "lost",
                "winPct",
                "gamesBehind"
              ]
            },
            "description": "Clés de `stats` à afficher, dans l'ordre"
          },
          "groups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WinPercentageGroup"
            }
          }
        },
        "required": [
          "kind",
          "sport",
          "competition",
          "season",
          "split",
          "columns",
          "groups"
        ],
        "description": "Classement au pourcentage de victoires"
      },
      "WinPercentageGroup": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "nullable": true,
            "minLength": 1,
            "description": "Identifiant opaque d'une poule"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "day": {
            "$ref": "#/components/schemas/DayRef"
          },
          "rows": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/WinPercentageRow"
            }
          }
        },
        "required": [
          "id",
          "name",
          "day",
          "rows"
        ],
        "description": "Une poule et son classement après `day` ; `id` vaut `null` pour une phase sans poule"
      },
      "WinPercentageRow": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "evolution": {
            "type": "integer",
            "nullable": true,
            "description": "Évolution de la place depuis la journée précédente"
          },
          "competitor": {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          "stats": {
            "$ref": "#/components/schemas/WinPercentageStats"
          }
        },
        "required": [
          "position",
          "evolution",
          "competitor",
          "stats"
        ]
      },
      "WinPercentageStats": {
        "type": "object",
        "properties": {
          "played": {
            "type": "integer",
            "minimum": 0
          },
          "won": {
            "type": "integer",
            "minimum": 0
          },
          "lost": {
            "type": "integer",
            "minimum": 0
          },
          "winPct": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Part de victoires, de 0 à 1"
          },
          "gamesBehind": {
            "type": "number",
            "description": "Retard sur le premier de la poule"
          }
        },
        "required": [
          "played",
          "won",
          "lost",
          "winPct",
          "gamesBehind"
        ],
        "description": "Classement au pourcentage de victoires (NBA…)"
      },
      "ContestsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/ApiListMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiListLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "Contest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/HeadToHeadContest"
          },
          {
            "$ref": "#/components/schemas/RankedContest"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "head-to-head": "#/components/schemas/HeadToHeadContest",
            "ranked": "#/components/schemas/RankedContest"
          }
        },
        "description": "Un match ou une épreuve ; sa forme dépend de `type`"
      },
      "HeadToHeadContest": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "head-to-head"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GroupRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DayRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VenueRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "home": {
            "$ref": "#/components/schemas/ContestSide"
          },
          "away": {
            "$ref": "#/components/schemas/ContestSide"
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "competition",
          "season",
          "phase",
          "group",
          "day",
          "startsAt",
          "status",
          "statusLabel",
          "venue",
          "home",
          "away"
        ],
        "description": "Un duel : match, combat"
      },
      "ContestStatus": {
        "type": "string",
        "minLength": 1,
        "description": "Statut normalisé ; `statusLabel` donne le libellé exact de la source (« Mi-temps », « Manche 3 »…). Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "scheduled",
          "live",
          "finished",
          "postponed",
          "cancelled"
        ]
      },
      "VenueRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un stade ou d'un site"
          },
          "name": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name"
        ],
        "description": "Un stade ou un site"
      },
      "ContestSide": {
        "type": "object",
        "properties": {
          "competitor": {
            "$ref": "#/components/schemas/ContestCompetitor"
          },
          "score": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "`null` tant que le contest n'a pas commencé"
          }
        },
        "required": [
          "competitor",
          "score"
        ],
        "description": "Un camp d'un duel et son score principal"
      },
      "ContestCompetitor": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          {
            "$ref": "#/components/schemas/PersonCompetitor"
          },
          {
            "$ref": "#/components/schemas/CrewCompetitor"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "team": "#/components/schemas/TeamCompetitor",
            "person": "#/components/schemas/PersonCompetitor",
            "crew": "#/components/schemas/CrewCompetitor"
          }
        },
        "description": "Un concurrent : équipe, athlète ou équipage"
      },
      "PersonCompetitor": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une personne (athlète, arbitre)"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "photo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonPhoto"
              },
              {
                "nullable": true
              }
            ]
          },
          "type": {
            "type": "string",
            "enum": [
              "person"
            ]
          }
        },
        "required": [
          "id",
          "name",
          "photo",
          "type"
        ],
        "description": "Un athlète seul"
      },
      "CrewCompetitor": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "crew"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un équipage (relais, double)"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PersonRef"
            }
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "members"
        ],
        "description": "Plusieurs athlètes sans équipe (relais, double) ; `name` réunit leurs noms"
      },
      "RankedContest": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "ranked"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GroupRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DayRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/VenueRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankedEntry"
            }
          },
          "entryCount": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "competition",
          "season",
          "phase",
          "group",
          "day",
          "startsAt",
          "status",
          "statusLabel",
          "venue",
          "name",
          "entries",
          "entryCount"
        ],
        "description": "Une épreuve classée : course, concours. Dans une liste, `entries` ne contient que le podium ; `entryCount` compte tous les concurrents."
      },
      "RankedEntry": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "exclusiveMinimum": true
          },
          "competitor": {
            "$ref": "#/components/schemas/ContestCompetitor"
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ContestResult"
              },
              {
                "nullable": true
              }
            ]
          },
          "medal": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Medal"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "position",
          "competitor",
          "result",
          "medal"
        ],
        "description": "Un concurrent d'une épreuve classée ; `position` vaut `null` pour un non classé"
      },
      "ContestResult": {
        "type": "object",
        "properties": {
          "value": {
            "type": "number"
          },
          "unit": {
            "$ref": "#/components/schemas/ContestResultUnit"
          },
          "display": {
            "type": "string",
            "description": "Résultat déjà formaté (« 26:43.79 »)"
          }
        },
        "required": [
          "value",
          "unit",
          "display"
        ],
        "description": "Résultat d'un concurrent dans une épreuve classée"
      },
      "ContestResultUnit": {
        "type": "string",
        "minLength": 1,
        "description": "Unité du résultat ; `value` est en millisecondes pour `time`. Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "time",
          "points",
          "distance",
          "other"
        ]
      },
      "Medal": {
        "type": "string",
        "enum": [
          "gold",
          "silver",
          "bronze"
        ]
      },
      "ContestStatusFilter": {
        "type": "string",
        "enum": [
          "scheduled",
          "live",
          "finished",
          "postponed",
          "cancelled"
        ],
        "description": "Seulement les contests de ce statut"
      },
      "ContestDetailResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ContestDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "ContestDetail": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/HeadToHeadContestDetail"
          },
          {
            "$ref": "#/components/schemas/RankedContestDetail"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "head-to-head": "#/components/schemas/HeadToHeadContestDetail",
            "ranked": "#/components/schemas/RankedContestDetail"
          }
        }
      },
      "HeadToHeadContestDetail": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "head-to-head"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GroupRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DayRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "nullable": true
              }
            ]
          },
          "home": {
            "$ref": "#/components/schemas/ContestSide"
          },
          "away": {
            "$ref": "#/components/schemas/ContestSide"
          },
          "audience": {
            "type": "integer",
            "nullable": true,
            "minimum": 0
          },
          "officials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Official"
            }
          },
          "periods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PeriodScore"
            }
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "competition",
          "season",
          "phase",
          "group",
          "day",
          "startsAt",
          "status",
          "statusLabel",
          "venue",
          "home",
          "away",
          "audience",
          "officials",
          "periods"
        ],
        "description": "Un duel en détail : périodes, stade, affluence, arbitres"
      },
      "Venue": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un stade ou d'un site"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "capacity": {
            "type": "integer",
            "nullable": true,
            "minimum": 0
          }
        },
        "required": [
          "id",
          "name",
          "capacity"
        ],
        "description": "Un stade ou un site, avec sa capacité"
      },
      "Official": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string",
            "nullable": true,
            "description": "Rôle (« Principal », « Assistant »…)"
          },
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "role",
          "person",
          "country"
        ],
        "description": "Un arbitre ou officiel, et sa nationalité"
      },
      "Country": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un pays"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "code": {
            "type": "string",
            "nullable": true,
            "pattern": "^[A-Z]{2,3}$",
            "description": "Code CIO du pays (`FRA`) ; à défaut, son code iDalgo (`VA`)"
          },
          "flag": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CountryFlag"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "code",
          "flag"
        ],
        "description": "Un pays ; `code` est `null` si la source n'en a pas"
      },
      "PeriodScore": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true
          },
          "home": {
            "type": "number",
            "nullable": true,
            "minimum": 0
          },
          "away": {
            "type": "number",
            "nullable": true,
            "minimum": 0
          }
        },
        "required": [
          "name",
          "home",
          "away"
        ],
        "description": "Score d'une période pour chaque camp : mi-temps, set, tie-break…"
      },
      "RankedContestDetail": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "ranked"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "group": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/GroupRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DayRef"
              },
              {
                "nullable": true
              }
            ]
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "nullable": true
              }
            ]
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankedEntry"
            }
          },
          "entryCount": {
            "type": "integer",
            "minimum": 0
          },
          "audience": {
            "type": "integer",
            "nullable": true,
            "minimum": 0
          },
          "officials": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Official"
            }
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "competition",
          "season",
          "phase",
          "group",
          "day",
          "startsAt",
          "status",
          "statusLabel",
          "venue",
          "name",
          "entries",
          "entryCount",
          "audience",
          "officials"
        ],
        "description": "Une épreuve classée en détail : `entries` contient tous les concurrents"
      },
      "ContestLineupsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ContestLineups"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "ContestLineups": {
        "type": "object",
        "properties": {
          "contest": {
            "$ref": "#/components/schemas/ContestRef"
          },
          "lineups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Lineup"
            }
          }
        },
        "required": [
          "contest",
          "lineups"
        ]
      },
      "ContestRef": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          }
        },
        "required": [
          "id",
          "startsAt"
        ],
        "description": "Un contest, en référence légère : sa fiche est `/v1/contests/{id}`"
      },
      "Lineup": {
        "type": "object",
        "properties": {
          "competitor": {
            "$ref": "#/components/schemas/ContestCompetitor"
          },
          "formation": {
            "type": "string",
            "nullable": true,
            "description": "Système de jeu (« 4-3-3 »)"
          },
          "starters": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LineupPlayer"
            }
          },
          "substitutes": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LineupPlayer"
            }
          },
          "coach": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Entraîneur de l'équipe à la date du match, d'après sa carrière (la source ne donne pas l'encadrement d'un match) ; `null` s'il n'est pas connu"
          }
        },
        "required": [
          "competitor",
          "formation",
          "starters",
          "substitutes",
          "coach"
        ],
        "description": "Composition d'un camp : système de jeu, titulaires, remplaçants, entraîneur"
      },
      "LineupPlayer": {
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "shirt": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Numéro de maillot"
          },
          "captain": {
            "type": "boolean"
          },
          "position": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PitchPosition"
              },
              {
                "nullable": true
              }
            ]
          },
          "positionLabel": {
            "type": "string",
            "nullable": true,
            "description": "Poste du joueur (« Gardien », « Milieu »…), d'après sa carrière dans l'équipe à la date du match ; `null` si elle ne le dit pas"
          }
        },
        "required": [
          "person",
          "shirt",
          "captain",
          "position",
          "positionLabel"
        ],
        "description": "Un joueur d'une composition ; `position` (place sur le terrain) vaut `null` pour un remplaçant"
      },
      "PitchPosition": {
        "type": "object",
        "properties": {
          "x": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          },
          "y": {
            "type": "number",
            "minimum": 0,
            "maximum": 100
          }
        },
        "required": [
          "x",
          "y"
        ],
        "description": "Coordonnées sur le terrain : `x` en % de sa largeur (0 : gauche), `y` en % de sa longueur (0 : le but de l'équipe)"
      },
      "ContestActionsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ContestActions"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "ContestActions": {
        "type": "object",
        "properties": {
          "contest": {
            "$ref": "#/components/schemas/ContestRef"
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContestAction"
            },
            "description": "Actions dans l'ordre du match ; vide si le match n'est pas couvert"
          }
        },
        "required": [
          "contest",
          "actions"
        ]
      },
      "ContestAction": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une action de match (but, carton…)"
          },
          "type": {
            "$ref": "#/components/schemas/ActionType"
          },
          "family": {
            "$ref": "#/components/schemas/ActionFamily"
          },
          "label": {
            "type": "string",
            "nullable": true,
            "description": "Libellé de `type` (« But sur penalty »)"
          },
          "minute": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "Minute de jeu. Le temps additionnel la prolonge au-delà de la fin de la période : 48 en « 1ère mi-temps » se lit 45+3. Un tir au but porte son rang dans la séance (1, 2, 3…)"
          },
          "period": {
            "type": "string",
            "nullable": true,
            "description": "Période de jeu (« 1ère mi-temps », « Tirs au but »…)"
          },
          "side": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Side"
              },
              {
                "nullable": true
              }
            ],
            "description": "Camp de l'action ; pour un but contre son camp, le camp crédité du but. `null` pour une action sans équipe (VAR)"
          },
          "person": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Auteur : buteur, passeur décisif, joueur averti, joueur entrant…"
          },
          "relatedPerson": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Seconde personne : buteur servi par une passe décisive, joueur sortant d'un remplacement. Un but n'en a pas : sa passe décisive est une action à part, à la même minute"
          },
          "occurredAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Heure de l'action, si connue"
          }
        },
        "required": [
          "id",
          "type",
          "family",
          "label",
          "minute",
          "period",
          "side",
          "person",
          "relatedPerson",
          "occurredAt"
        ],
        "description": "Une action de match : but, carton, remplacement, tir, faute…"
      },
      "ActionType": {
        "type": "string",
        "minLength": 1,
        "description": "Nature exacte d'une action (« but sur penalty », « deuxième carton jaune »…) ; `label` en donne le libellé traduit. Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "goal",
          "header-goal",
          "penalty-goal",
          "free-kick-goal",
          "olympic-goal",
          "own-goal",
          "disallowed-goal",
          "shot",
          "missed-penalty",
          "shootout-scored",
          "shootout-missed",
          "yellow-card",
          "second-yellow-card",
          "red-card",
          "substitution",
          "injury-substitution",
          "assist",
          "corner-delivery",
          "free-kick-delivery",
          "pass",
          "chance",
          "foul",
          "penalty-conceded",
          "offside",
          "corner",
          "free-kick",
          "var-goal-awarded",
          "var-goal-disallowed",
          "var-penalty-awarded",
          "var-penalty-cancelled",
          "var-red-card-awarded",
          "var-red-card-cancelled",
          "var",
          "other"
        ]
      },
      "ActionFamily": {
        "type": "string",
        "minLength": 1,
        "description": "Famille d'une action, pour filtrer les temps forts : `goal` réunit tous les buts marqués (de la tête, sur penalty…), hors buts contre son camp (`own-goal`) et buts refusés (`disallowed-goal`). Liste ouverte : ignorer une valeur inconnue.",
        "x-extensible-enum": [
          "goal",
          "own-goal",
          "disallowed-goal",
          "shot",
          "shootout",
          "card",
          "substitution",
          "pass",
          "chance",
          "foul",
          "offside",
          "set-piece",
          "var",
          "other"
        ]
      },
      "Side": {
        "type": "string",
        "enum": [
          "home",
          "away"
        ],
        "description": "Camp d'un duel : à domicile ou à l'extérieur"
      },
      "TeamDetailResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TeamDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "TeamDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une équipe"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamLogo"
              },
              {
                "nullable": true
              }
            ]
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ],
            "description": "Sport des carrières de ses membres ; `null` sans carrière connue"
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "nullable": true
              }
            ]
          },
          "venue": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Venue"
              },
              {
                "nullable": true
              }
            ],
            "description": "Stade où l'équipe reçoit"
          }
        },
        "required": [
          "id",
          "name",
          "logo",
          "sport",
          "country",
          "venue"
        ],
        "description": "Fiche d'une équipe : pays, sport, stade"
      },
      "TeamSquadResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TeamSquad"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "TeamSquad": {
        "type": "object",
        "properties": {
          "team": {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Saison demandée ; `null` pour l'effectif du jour"
          },
          "members": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SquadMember"
            },
            "description": "Les joueurs (par poste, puis numéro), puis l'encadrement"
          }
        },
        "required": [
          "team",
          "season",
          "members"
        ],
        "description": "Effectif d'une équipe : d'une saison, ou à défaut du jour"
      },
      "SquadMember": {
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "role": {
            "$ref": "#/components/schemas/SquadRole"
          },
          "function": {
            "type": "string",
            "nullable": true,
            "description": "Fonction telle que la source la nomme (« Joueur », « Entraîneur »…)"
          },
          "position": {
            "type": "string",
            "nullable": true,
            "description": "Poste (« Gardien », « Attaquant »…)"
          },
          "shirt": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Numéro de maillot"
          },
          "nationality": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "nullable": true
              }
            ]
          },
          "birthDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "height": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Taille, en centimètres"
          },
          "weight": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Poids, en kilogrammes"
          },
          "from": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Arrivée dans l'équipe"
          },
          "until": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Départ de l'équipe ; `null` s'il n'est pas prévu"
          }
        },
        "required": [
          "person",
          "role",
          "function",
          "position",
          "shirt",
          "nationality",
          "birthDate",
          "height",
          "weight",
          "from",
          "until"
        ],
        "description": "Un membre de l'effectif, le temps de sa carrière dans l'équipe"
      },
      "SquadRole": {
        "type": "string",
        "enum": [
          "player",
          "staff"
        ],
        "description": "Joueur, ou membre de l'encadrement (entraîneur, dirigeant…) ; `function` le précise"
      },
      "TeamFormResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TeamForm"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "TeamForm": {
        "type": "object",
        "properties": {
          "team": {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          "form": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormEntry"
            }
          }
        },
        "required": [
          "team",
          "form"
        ],
        "description": "Derniers matchs terminés d'une équipe, du plus récent au plus ancien"
      },
      "FormEntry": {
        "type": "object",
        "properties": {
          "contest": {
            "$ref": "#/components/schemas/ContestRef"
          },
          "side": {
            "$ref": "#/components/schemas/Side"
          },
          "opponent": {
            "$ref": "#/components/schemas/ContestCompetitor"
          },
          "score": {
            "$ref": "#/components/schemas/FormScore"
          },
          "result": {
            "$ref": "#/components/schemas/FormResult"
          }
        },
        "required": [
          "contest",
          "side",
          "opponent",
          "score",
          "result"
        ],
        "description": "Un match de la forme récente, du point de vue de l'équipe"
      },
      "FormScore": {
        "type": "object",
        "properties": {
          "scored": {
            "type": "number",
            "nullable": true,
            "minimum": 0
          },
          "conceded": {
            "type": "number",
            "nullable": true,
            "minimum": 0
          }
        },
        "required": [
          "scored",
          "conceded"
        ],
        "description": "Score du point de vue de l'équipe : buts ou points marqués et encaissés"
      },
      "FormResult": {
        "type": "string",
        "enum": [
          "win",
          "draw",
          "loss"
        ]
      },
      "PersonDetailResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PersonDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "PersonDetail": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une personne (athlète, arbitre)"
          },
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Prénom et nom"
          },
          "photo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PersonPhoto"
              },
              {
                "nullable": true
              }
            ]
          },
          "firstName": {
            "type": "string",
            "nullable": true
          },
          "lastName": {
            "type": "string",
            "nullable": true
          },
          "nickname": {
            "type": "string",
            "nullable": true,
            "description": "Nom d'usage s'il diffère (« Neymar »)"
          },
          "gender": {
            "$ref": "#/components/schemas/Gender"
          },
          "birthDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "birthPlace": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Place"
              },
              {
                "nullable": true
              }
            ]
          },
          "deathDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "nationalities": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Country"
            },
            "description": "Dans l'ordre de la source"
          },
          "height": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Taille en centimètres"
          },
          "weight": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Poids en kilogrammes"
          },
          "website": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "name",
          "photo",
          "firstName",
          "lastName",
          "nickname",
          "gender",
          "birthDate",
          "birthPlace",
          "deathDate",
          "nationalities",
          "height",
          "weight",
          "website"
        ],
        "description": "Fiche d'une personne : athlète, entraîneur, arbitre"
      },
      "Gender": {
        "type": "string",
        "enum": [
          "male",
          "female"
        ],
        "description": "Sexe tel que la source le classe (catégories masculines et féminines)"
      },
      "Place": {
        "type": "object",
        "properties": {
          "city": {
            "type": "string",
            "nullable": true
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "city",
          "country"
        ],
        "description": "Une ville et son pays"
      },
      "PersonCareerResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PersonCareer"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "PersonCareer": {
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CareerEntry"
              },
              {
                "nullable": true
              }
            ],
            "description": "L'engagement en cours : le club plutôt que la sélection, puis le plus récent ; `null` sans engagement actuel"
          },
          "spells": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CareerSpell"
            },
            "description": "Les séjours, du plus récent au plus ancien : le parcours résumé"
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CareerEntry"
            },
            "description": "Du plus récent au plus ancien"
          }
        },
        "required": [
          "person",
          "current",
          "spells",
          "entries"
        ],
        "description": "Parcours d'une personne, toutes équipes et tous sports"
      },
      "CareerEntry": {
        "type": "object",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "`null` pour une carrière sans équipe (sport individuel)"
          },
          "national": {
            "type": "boolean",
            "description": "Sélection nationale (l'équipe porte le nom de son pays) plutôt qu'un club"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "role": {
            "$ref": "#/components/schemas/SquadRole"
          },
          "function": {
            "type": "string",
            "nullable": true,
            "description": "Fonction telle que la source la nomme (« Joueur », « Entraineur »…)"
          },
          "position": {
            "type": "string",
            "nullable": true,
            "description": "Poste (« Gardien », « Attaquant »…)"
          },
          "shirt": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "description": "Numéro de maillot"
          },
          "from": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "until": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "`null` si le départ n'est pas prévu"
          }
        },
        "required": [
          "team",
          "national",
          "sport",
          "role",
          "function",
          "position",
          "shirt",
          "from",
          "until"
        ],
        "description": "Un passage dans une équipe, tel que la source le découpe (en général une ligne par saison)"
      },
      "CareerSpell": {
        "type": "object",
        "properties": {
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "`null` pour une carrière sans équipe (sport individuel)"
          },
          "national": {
            "type": "boolean",
            "description": "Sélection nationale (l'équipe porte le nom de son pays) plutôt qu'un club"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "role": {
            "$ref": "#/components/schemas/SquadRole"
          },
          "function": {
            "type": "string",
            "nullable": true,
            "description": "Fonction du passage le plus récent"
          },
          "position": {
            "type": "string",
            "nullable": true,
            "description": "Poste du passage le plus récent"
          },
          "from": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "until": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "`null` si le départ n'est pas prévu"
          }
        },
        "required": [
          "team",
          "national",
          "sport",
          "role",
          "function",
          "position",
          "from",
          "until"
        ],
        "description": "Un séjour dans une équipe : ses passages consécutifs dans le même rôle, regroupés (Monaco 2015-2017, puis Paris SG 2017-2024…)"
      },
      "PersonSeasonStatsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PersonSeasonStats"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "PersonSeasonStats": {
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonRef"
          },
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "Dernière équipe du joueur dans la saison ; `null` s'il n'y a aucune action"
          },
          "stats": {
            "$ref": "#/components/schemas/PlayerSeasonStats"
          }
        },
        "required": [
          "person",
          "competition",
          "season",
          "team",
          "stats"
        ],
        "description": "Buts, passes décisives et cartons d'un joueur sur une saison, servis seulement pour une saison dont presque tous les matchs joués ont leurs actions"
      },
      "PlayerSeasonStats": {
        "type": "object",
        "properties": {
          "appearances": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs joués : titulaire, ou entré en jeu"
          },
          "minutesPlayed": {
            "type": "integer",
            "minimum": 0,
            "description": "Minutes jouées, du coup d'envoi ou de l'entrée en jeu jusqu'à la sortie, l'expulsion ou la 90e (hors temps additionnel et prolongations)"
          },
          "starts": {
            "type": "integer",
            "minimum": 0,
            "description": "Titularisations"
          },
          "benches": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs commencés sur le banc, entré en jeu ou non"
          },
          "subbedIn": {
            "type": "integer",
            "minimum": 0,
            "description": "Entrées en jeu"
          },
          "subbedOut": {
            "type": "integer",
            "minimum": 0,
            "description": "Sorties en cours de match (remplacé)"
          },
          "goals": {
            "type": "integer",
            "minimum": 0,
            "description": "Buts, hors contre son camp et buts refusés"
          },
          "penaltyGoals": {
            "type": "integer",
            "minimum": 0,
            "description": "Dont buts sur penalty"
          },
          "assists": {
            "type": "integer",
            "minimum": 0
          },
          "yellowCards": {
            "type": "integer",
            "minimum": 0
          },
          "redCards": {
            "type": "integer",
            "minimum": 0,
            "description": "Rouges directs et deuxièmes jaunes"
          }
        },
        "required": [
          "appearances",
          "minutesPlayed",
          "starts",
          "benches",
          "subbedIn",
          "subbedOut",
          "goals",
          "penaltyGoals",
          "assists",
          "yellowCards",
          "redCards"
        ],
        "description": "Les statistiques d'un joueur sur une saison, tirées des compositions et des actions de match"
      },
      "HeadToHeadResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/HeadToHeadSummary"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "HeadToHeadSummary": {
        "type": "object",
        "properties": {
          "sides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/HeadToHeadSide"
            },
            "minItems": 2,
            "maxItems": 2
          },
          "contestCount": {
            "type": "integer",
            "minimum": 0
          },
          "draws": {
            "type": "integer",
            "minimum": 0
          },
          "averageScored": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "Buts ou points par match, des deux équipes ; `null` sans match"
          },
          "scorelessCount": {
            "type": "integer",
            "minimum": 0
          },
          "mostFrequentScore": {
            "type": "array",
            "nullable": true,
            "items": {
              "type": "number",
              "minimum": 0
            },
            "minItems": 2,
            "maxItems": 2,
            "description": "Score le plus fréquent, le plus haut en premier quel que soit le vainqueur"
          },
          "last": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            },
            "description": "Derniers matchs, du plus récent"
          }
        },
        "required": [
          "sides",
          "contestCount",
          "draws",
          "averageScored",
          "scorelessCount",
          "mostFrequentScore",
          "last"
        ],
        "description": "Bilan des confrontations terminées entre deux équipes, dans l'ordre demandé"
      },
      "HeadToHeadSide": {
        "type": "object",
        "properties": {
          "team": {
            "$ref": "#/components/schemas/TeamCompetitor"
          },
          "wins": {
            "type": "integer",
            "minimum": 0
          },
          "scored": {
            "type": "number",
            "minimum": 0,
            "description": "Buts ou points marqués selon le sport"
          }
        },
        "required": [
          "team",
          "wins",
          "scored"
        ],
        "description": "Le bilan d'une des deux équipes"
      },
      "LiveContestsResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LiveContest"
            }
          },
          "meta": {
            "$ref": "#/components/schemas/LiveListMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiListLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "LiveContest": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/LiveHeadToHead"
          },
          {
            "$ref": "#/components/schemas/LiveRanked"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "head-to-head": "#/components/schemas/LiveHeadToHead",
            "ranked": "#/components/schemas/LiveRanked"
          }
        }
      },
      "LiveHeadToHead": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "head-to-head"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "home": {
            "$ref": "#/components/schemas/LiveSide"
          },
          "away": {
            "$ref": "#/components/schemas/LiveSide"
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "startsAt",
          "status",
          "statusLabel",
          "home",
          "away"
        ],
        "description": "Duel en direct"
      },
      "LiveSide": {
        "type": "object",
        "properties": {
          "score": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "Score principal ; `null` tant que le match n'a pas commencé"
          }
        },
        "required": [
          "score"
        ],
        "description": "Un camp d'un duel en direct : la part de `ContestSide` qui bouge"
      },
      "LiveRanked": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "ranked"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "entries": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RankedEntry"
            }
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "startsAt",
          "status",
          "statusLabel",
          "entries"
        ],
        "description": "Épreuve classée en direct : le podium du moment"
      },
      "LiveListMeta": {
        "type": "object",
        "properties": {
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de génération de la réponse"
          },
          "version": {
            "type": "string",
            "enum": [
              "v1"
            ],
            "description": "Version du contrat de la réponse : `v1` pour une ressource `/v1`, celle du module pour un module (`/modules/<nom>/v<n>` → `v<n>`)"
          },
          "lang": {
            "$ref": "#/components/schemas/Lang"
          },
          "pollAfter": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Secondes avant de relire la vue (plus court pour les sports rapides) ; `null` quand plus rien ne bougera (tout est terminé, reporté ou annulé) : le widget s'arrête"
          },
          "cursor": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "generatedAt",
          "version",
          "lang",
          "pollAfter",
          "cursor"
        ]
      },
      "LiveContestResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/LiveContestDetail"
          },
          "meta": {
            "$ref": "#/components/schemas/LiveMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "LiveContestDetail": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/LiveHeadToHeadDetail"
          },
          {
            "$ref": "#/components/schemas/LiveRanked"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "head-to-head": "#/components/schemas/LiveHeadToHeadDetail",
            "ranked": "#/components/schemas/LiveRanked"
          }
        },
        "description": "Un seul contest en direct : un duel porte aussi ses périodes (mi-temps, sets…)"
      },
      "LiveHeadToHeadDetail": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "head-to-head"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "sport": {
            "$ref": "#/components/schemas/Sport"
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          },
          "home": {
            "$ref": "#/components/schemas/LiveSide"
          },
          "away": {
            "$ref": "#/components/schemas/LiveSide"
          },
          "periods": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PeriodScore"
            }
          },
          "highlights": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContestAction"
            },
            "description": "Temps forts dans l'ordre du match : buts (dont contre son camp), expulsions (rouge direct, deuxième jaune), tirs au but. Toutes les actions : `/v1/contests/{id}/actions`"
          }
        },
        "required": [
          "type",
          "id",
          "sport",
          "startsAt",
          "status",
          "statusLabel",
          "home",
          "away",
          "periods",
          "highlights"
        ],
        "description": "Duel en direct, avec ses périodes et ses temps forts"
      },
      "LiveMeta": {
        "type": "object",
        "properties": {
          "generatedAt": {
            "type": "string",
            "format": "date-time",
            "description": "Date de génération de la réponse"
          },
          "version": {
            "type": "string",
            "enum": [
              "v1"
            ],
            "description": "Version du contrat de la réponse : `v1` pour une ressource `/v1`, celle du module pour un module (`/modules/<nom>/v<n>` → `v<n>`)"
          },
          "lang": {
            "$ref": "#/components/schemas/Lang"
          },
          "pollAfter": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Secondes avant de relire la vue (plus court pour les sports rapides) ; `null` quand plus rien ne bougera (tout est terminé, reporté ou annulé) : le widget s'arrête"
          }
        },
        "required": [
          "generatedAt",
          "version",
          "lang",
          "pollAfter"
        ]
      },
      "SearchResponse": {
        "type": "object",
        "properties": {
          "data": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SearchHit"
            },
            "description": "Les meilleurs résultats d'abord : nom identique, puis nom qui commence par la recherche, puis le reste ; à égalité, le nom le plus court"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "SearchHit": {
        "oneOf": [
          {
            "$ref": "#/components/schemas/CompetitionSearchHit"
          },
          {
            "$ref": "#/components/schemas/TeamSearchHit"
          },
          {
            "$ref": "#/components/schemas/PersonSearchHit"
          }
        ],
        "discriminator": {
          "propertyName": "type",
          "mapping": {
            "competition": "#/components/schemas/CompetitionSearchHit",
            "team": "#/components/schemas/TeamSearchHit",
            "person": "#/components/schemas/PersonSearchHit"
          }
        },
        "description": "Une entité dont le nom correspond à la recherche"
      },
      "CompetitionSearchHit": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "competition"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une compétition"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CompetitionLogo"
              },
              {
                "nullable": true
              }
            ]
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "currentSeason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Saison en cours, l'entrée vers ses classements et son calendrier ; `null` quand la source n'en désigne pas"
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "logo",
          "sport",
          "currentSeason"
        ],
        "description": "Une compétition trouvée : sa fiche et ses saisons sont sous `/v1/competitions`"
      },
      "TeamSearchHit": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "team"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une équipe"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamLogo"
              },
              {
                "nullable": true
              }
            ]
          },
          "country": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Country"
              },
              {
                "nullable": true
              }
            ]
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "logo",
          "country"
        ],
        "description": "Une équipe trouvée : sa fiche est `/v1/teams/{id}`"
      },
      "PersonSearchHit": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "person"
            ]
          },
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une personne (athlète, arbitre)"
          },
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Prénom et nom"
          },
          "nickname": {
            "type": "string",
            "nullable": true,
            "description": "Nom d'usage s'il diffère (« Neymar »)"
          },
          "birthDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Pour départager deux homonymes"
          }
        },
        "required": [
          "type",
          "id",
          "name",
          "nickname",
          "birthDate"
        ],
        "description": "Une personne trouvée : sa fiche est `/v1/persons/{id}`"
      },
      "MatchListV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/MatchListV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "MatchListV1": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "days": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SeasonDay"
            },
            "description": "Journées de la saison, pour le sélecteur"
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonDay"
              },
              {
                "nullable": true
              }
            ]
          },
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            }
          },
          "hasMoreContests": {
            "type": "boolean",
            "description": "Vrai si la journée compte plus de contests que le module n'en renvoie (épreuves multisports)"
          }
        },
        "required": [
          "competition",
          "season",
          "days",
          "day",
          "contests",
          "hasMoreContests"
        ],
        "description": "Module de la liste de matchs (widget MatchList), v1 : tout ce que l'écran affiche en un appel. `day` est la journée affichée (par défaut la journée courante)."
      },
      "MatchListV1LiveResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/MatchListV1Live"
          },
          "meta": {
            "$ref": "#/components/schemas/LiveMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "MatchListV1Live": {
        "type": "object",
        "properties": {
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LiveContest"
            },
            "description": "Contests de la journée réduits à ce qui bouge (statut, score, heure), dans l'ordre du module : le widget les reporte sur ses cartes par `id`"
          }
        },
        "required": [
          "contests"
        ],
        "description": "Ce qui bouge sur une journée de la liste de matchs pendant qu'elle se joue, au format des vues `/v1/live`."
      },
      "TeamSheetV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/TeamSheetV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "TeamSheetV1": {
        "type": "object",
        "properties": {
          "team": {
            "$ref": "#/components/schemas/TeamDetail"
          },
          "season": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonRef"
              },
              {
                "nullable": true
              }
            ],
            "description": "Saison demandée ; `null` sans `season` (effectif du jour, toutes saisons)"
          },
          "squad": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SquadMember"
            },
            "description": "Les joueurs (par poste, puis numéro), puis l'encadrement"
          },
          "form": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormEntry"
            },
            "description": "Derniers matchs terminés, du plus récent au plus ancien"
          },
          "nextContest": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HeadToHeadContest"
              },
              {
                "$ref": "#/components/schemas/RankedContest"
              },
              {
                "nullable": true
              }
            ],
            "description": "Prochain match programmé ; `null` s'il n'y en a pas"
          },
          "competitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TeamSheetV1Competition"
            },
            "description": "Compétitions en cours de l'équipe (un match depuis 120 jours ou à venir), ou la saison demandée : bilan et matchs, la plus fournie d'abord"
          }
        },
        "required": [
          "team",
          "season",
          "squad",
          "form",
          "nextContest",
          "competitions"
        ],
        "description": "Module de la fiche équipe (widget TeamSheet), v1 : fiche, effectif, forme récente, prochain match, résultats et calendrier par compétition en un appel."
      },
      "TeamSheetV1Competition": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "record": {
            "$ref": "#/components/schemas/TeamSheetV1Record"
          },
          "remaining": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs restant à jouer (programmés, en cours ou reportés)"
          },
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            },
            "description": "Tous les matchs de l'équipe dans la saison, dans l'ordre chronologique"
          }
        },
        "required": [
          "competition",
          "season",
          "record",
          "remaining",
          "contests"
        ],
        "description": "Une compétition de l'équipe : son bilan et ses matchs de la saison"
      },
      "TeamSheetV1Record": {
        "type": "object",
        "properties": {
          "played": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs terminés"
          },
          "wins": {
            "type": "integer",
            "minimum": 0
          },
          "draws": {
            "type": "integer",
            "minimum": 0
          },
          "losses": {
            "type": "integer",
            "minimum": 0
          },
          "winPct": {
            "type": "number",
            "minimum": 0,
            "maximum": 1,
            "description": "Part de victoires sur les matchs terminés, de 0 à 1 ; 0 sans match"
          },
          "home": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs terminés joués à domicile"
          },
          "away": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs terminés joués à l'extérieur"
          },
          "scored": {
            "type": "number",
            "minimum": 0,
            "description": "Buts ou points marqués"
          },
          "conceded": {
            "type": "number",
            "minimum": 0,
            "description": "Buts ou points encaissés"
          }
        },
        "required": [
          "played",
          "wins",
          "draws",
          "losses",
          "winPct",
          "home",
          "away",
          "scored",
          "conceded"
        ],
        "description": "Bilan des matchs terminés de l'équipe dans une compétition"
      },
      "PlayerCardV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/PlayerCardV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "PlayerCardV1": {
        "type": "object",
        "properties": {
          "person": {
            "$ref": "#/components/schemas/PersonDetail"
          },
          "current": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CareerEntry"
              },
              {
                "nullable": true
              }
            ],
            "description": "Le passage en cours le plus récent ; `null` sans engagement actuel"
          },
          "career": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/CareerEntry"
            },
            "description": "Du plus récent au plus ancien"
          },
          "latestSeason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerCardV1Season"
              },
              {
                "nullable": true
              }
            ],
            "description": "Dernière saison où le joueur a joué ; `null` sans aucun match connu"
          }
        },
        "required": [
          "person",
          "current",
          "career",
          "latestSeason"
        ],
        "description": "Module de la fiche joueur (widget PlayerCard), v1 : identité, engagement actuel, parcours et stats de la saison en un appel."
      },
      "PlayerCardV1Season": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string",
            "nullable": true,
            "description": "Saison (« 2026/2027 »)"
          },
          "total": {
            "$ref": "#/components/schemas/PlayerCardV1SeasonTotal"
          },
          "competitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/PlayerCardV1Competition"
            },
            "description": "La compétition où il a le plus joué d'abord"
          }
        },
        "required": [
          "name",
          "total",
          "competitions"
        ],
        "description": "La dernière saison où le joueur a joué, toutes compétitions"
      },
      "PlayerCardV1SeasonTotal": {
        "type": "object",
        "properties": {
          "stats": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerSeasonStats"
              },
              {
                "nullable": true
              }
            ],
            "description": "Toutes compétitions ; `null` si l'une d'elles n'a pas ses stats"
          },
          "record": {
            "$ref": "#/components/schemas/PlayerCardV1Record"
          }
        },
        "required": [
          "stats",
          "record"
        ],
        "description": "Toutes compétitions confondues"
      },
      "PlayerCardV1Record": {
        "type": "object",
        "properties": {
          "played": {
            "type": "integer",
            "minimum": 0,
            "description": "Matchs terminés que le joueur a joués"
          },
          "wins": {
            "type": "integer",
            "minimum": 0
          },
          "draws": {
            "type": "integer",
            "minimum": 0
          },
          "losses": {
            "type": "integer",
            "minimum": 0
          }
        },
        "required": [
          "played",
          "wins",
          "draws",
          "losses"
        ],
        "description": "Bilan des matchs terminés joués par le joueur, du point de vue de son équipe"
      },
      "PlayerCardV1Competition": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "team": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "Équipe du joueur à son dernier match de la compétition"
          },
          "stats": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PlayerSeasonStats"
              },
              {
                "nullable": true
              }
            ],
            "description": "`null` si les actions de match de la saison sont incomplètes (import partiel de la source)"
          },
          "record": {
            "$ref": "#/components/schemas/PlayerCardV1Record"
          },
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            },
            "description": "Matchs joués par le joueur, du plus récent au plus ancien"
          }
        },
        "required": [
          "competition",
          "season",
          "team",
          "stats",
          "record",
          "contests"
        ],
        "description": "Une compétition de la saison du joueur : ses stats, son bilan et ses matchs"
      },
      "MatchSheetV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/MatchSheetV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "MatchSheetV1": {
        "type": "object",
        "properties": {
          "contest": {
            "$ref": "#/components/schemas/HeadToHeadContestDetail"
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContestAction"
            },
            "description": "Buts, cartons, remplacements et tirs au but, dans l'ordre du match ; vide si le match n'a pas commencé ou si ses actions ne sont pas importées"
          },
          "lineups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Lineup"
            },
            "description": "Composition de chaque équipe ; titulaires et remplaçants vides si elle n'est pas connue"
          },
          "standings": {
            "$ref": "#/components/schemas/MatchSheetV1Standings"
          },
          "form": {
            "$ref": "#/components/schemas/MatchSheetV1Form"
          },
          "keyPlayers": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MatchSheetV1KeyPlayers"
              },
              {
                "nullable": true
              }
            ],
            "description": "Joueurs clés de chaque équipe ; `null` si les actions de la saison ne sont pas importées pour presque tous ses matchs joués"
          },
          "headToHead": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HeadToHeadSummary"
              },
              {
                "nullable": true
              }
            ],
            "description": "Confrontations des deux équipes avant ce match, toutes saisons confondues ; `null` si l'une des équipes n'est pas connue"
          }
        },
        "required": [
          "contest",
          "actions",
          "lineups",
          "standings",
          "form",
          "keyPlayers",
          "headToHead"
        ],
        "description": "Module de la feuille de match (widget MatchSheet), v1 : en-tête, informations, actions, compositions et avant-match d'un duel en un appel. Forme et confrontations s'arrêtent avant le match, le classement est celui de sa date."
      },
      "MatchSheetV1Standings": {
        "type": "object",
        "properties": {
          "overall": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueTable"
              },
              {
                "$ref": "#/components/schemas/WinPercentageTable"
              },
              {
                "nullable": true
              }
            ]
          },
          "home": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueTable"
              },
              {
                "$ref": "#/components/schemas/WinPercentageTable"
              },
              {
                "nullable": true
              }
            ],
            "description": "Matchs à domicile seulement"
          },
          "away": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LeagueTable"
              },
              {
                "$ref": "#/components/schemas/WinPercentageTable"
              },
              {
                "nullable": true
              }
            ],
            "description": "Matchs à l'extérieur seulement"
          }
        },
        "required": [
          "overall",
          "home",
          "away"
        ],
        "description": "Classement de la poule du match à sa date (après la dernière journée jouée ce jour-là) ; `null` si la saison n'a pas de classement"
      },
      "MatchSheetV1Form": {
        "type": "object",
        "properties": {
          "home": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormEntry"
            }
          },
          "away": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/FormEntry"
            }
          }
        },
        "required": [
          "home",
          "away"
        ],
        "description": "Derniers matchs terminés de chaque équipe avant ce match, du plus récent"
      },
      "MatchSheetV1KeyPlayers": {
        "type": "object",
        "properties": {
          "home": {
            "$ref": "#/components/schemas/MatchSheetV1TeamLeaders"
          },
          "away": {
            "$ref": "#/components/schemas/MatchSheetV1TeamLeaders"
          }
        },
        "required": [
          "home",
          "away"
        ],
        "description": "Joueurs clés de chaque équipe"
      },
      "MatchSheetV1TeamLeaders": {
        "type": "object",
        "properties": {
          "scorer": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonLeader"
              },
              {
                "nullable": true
              }
            ],
            "description": "Meilleur buteur ; `null` si personne n'a marqué"
          },
          "assister": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SeasonLeader"
              },
              {
                "nullable": true
              }
            ],
            "description": "Meilleur passeur décisif ; `null` si personne n'en a donné"
          }
        },
        "required": [
          "scorer",
          "assister"
        ],
        "description": "Joueurs clés d'une équipe, sur ses matchs de la saison du match"
      },
      "MatchSheetV1LiveResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/MatchSheetV1Live"
          },
          "meta": {
            "$ref": "#/components/schemas/LiveMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "MatchSheetV1Live": {
        "type": "object",
        "properties": {
          "contest": {
            "$ref": "#/components/schemas/HeadToHeadContestDetail"
          },
          "actions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ContestAction"
            },
            "description": "Buts, cartons, remplacements et tirs au but, dans l'ordre du match ; vide si le match n'a pas commencé ou si ses actions ne sont pas importées"
          },
          "lineups": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Lineup"
            },
            "description": "Composition de chaque équipe ; titulaires et remplaçants vides si elle n'est pas connue"
          }
        },
        "required": [
          "contest",
          "actions",
          "lineups"
        ],
        "description": "Ce qui bouge sur la feuille pendant le match : en-tête (statut, score, périodes), actions et compositions, sous la même forme que le module. Le widget remplace ces trois parties de la feuille chargée une fois, l'avant-match ne bougeant pas."
      },
      "ScoreCenterV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ScoreCenterV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "ScoreCenterV1": {
        "type": "object",
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "description": "Jour affiché, dans le fuseau `timeZone`"
          },
          "timeZone": {
            "type": "string",
            "example": "Europe/Paris",
            "description": "Fuseau du jour (nom IANA canonique)"
          },
          "previousDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour précédent qui a des matchs pour ce sport et ces compétitions (flèche gauche) ; `null` s'il n'y en a pas"
          },
          "nextDate": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour suivant qui a des matchs pour ce sport et ces compétitions (flèche droite) ; `null` s'il n'y en a pas"
          },
          "competitions": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ScoreCenterV1Competition"
            },
            "description": "Blocs par compétition, dans l'ordre de `competitions=` (à défaut, de la liste par défaut du sport) ; vide un jour sans match"
          },
          "hasMoreContests": {
            "type": "boolean",
            "description": "Vrai si le jour compte plus de matchs que le module n'en renvoie"
          }
        },
        "required": [
          "date",
          "timeZone",
          "previousDate",
          "nextDate",
          "competitions",
          "hasMoreContests"
        ],
        "description": "Module du Score Center (widget ScoreCenter), v1 : les matchs d'un sport sur un jour, groupés par compétition, et les jours voisins qui en ont."
      },
      "ScoreCenterV1Competition": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "phase": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ScoreCenterV1Phase"
              },
              {
                "nullable": true
              }
            ]
          },
          "day": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ScoreCenterV1Day"
              },
              {
                "nullable": true
              }
            ]
          },
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Contest"
            },
            "description": "Matchs du bloc, par heure de début"
          }
        },
        "required": [
          "competition",
          "season",
          "phase",
          "day",
          "contests"
        ],
        "description": "Un bloc du Score Center : les matchs du jour d'une compétition. `phase` et `day` sont ceux de la plupart de ses matchs (un match en retard garde les siens), pour l'en-tête « Journée 17 » ou le nom de la phase. Le panneau Classement lit `season` via `/v1/standings?season=`."
      },
      "ScoreCenterV1Phase": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une phase"
          },
          "name": {
            "type": "string",
            "nullable": true
          },
          "format": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PhaseFormat"
              },
              {
                "nullable": true
              }
            ],
            "description": "Format de la phase, comme dans /v1/seasons/{id} ; `null` quand la source ne permet pas de le déduire"
          }
        },
        "required": [
          "id",
          "name",
          "format"
        ],
        "description": "La phase d'un bloc et son format : en phase à élimination (`knockout`), pas de classement à ouvrir"
      },
      "ScoreCenterV1Day": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'une journée"
          },
          "date": {
            "type": "string",
            "nullable": true,
            "format": "date",
            "description": "Jour calendaire ISO 8601 (`2026-10-10`)"
          },
          "number": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Rang de la journée dans sa phase (« Journée 17 »)"
          }
        },
        "required": [
          "id",
          "date",
          "number"
        ],
        "description": "La journée d'un bloc et son rang"
      },
      "ScoreCenterV1Status": {
        "type": "string",
        "enum": [
          "live",
          "finished",
          "scheduled"
        ],
        "description": "Filtre du Score Center : en cours (`live`), terminés (`finished`) ou à venir (`scheduled`) ; sans filtre, tous. Liste fermée : une valeur inconnue est refusée (`400`)."
      },
      "ScoreCenterV1LiveResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/ScoreCenterV1Live"
          },
          "meta": {
            "$ref": "#/components/schemas/LiveMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "ScoreCenterV1Live": {
        "type": "object",
        "properties": {
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/LiveContest"
            },
            "description": "Matchs du jour réduits à ce qui bouge (statut, score, heure), dans l'ordre des blocs du module : le widget les reporte sur ses cartes par `id`"
          }
        },
        "required": [
          "contests"
        ],
        "description": "Ce qui bouge sur le jour du Score Center pendant qu'il se joue, au format des vues `/v1/live`."
      },
      "BracketV1Response": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/BracketV1"
          },
          "meta": {
            "$ref": "#/components/schemas/ApiMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "BracketV1": {
        "type": "object",
        "properties": {
          "competition": {
            "$ref": "#/components/schemas/CompetitionRef"
          },
          "season": {
            "$ref": "#/components/schemas/SeasonRef"
          },
          "sport": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Sport"
              },
              {
                "nullable": true
              }
            ]
          },
          "rounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BracketV1Round"
            },
            "description": "Tours du tableau dans l'ordre : la phase demandée, puis chaque phase à élimination qui la suit jusqu'à la finale"
          }
        },
        "required": [
          "competition",
          "season",
          "sport",
          "rounds"
        ],
        "description": "Module du tableau de phase finale (widget Bracket), v1 : les tours d'une phase à élimination, leurs oppositions (aller, retour, cumul, tirs au but), le qualifié et la place de chaque opposition dans le tableau. Football."
      },
      "BracketV1Round": {
        "type": "object",
        "properties": {
          "phase": {
            "$ref": "#/components/schemas/PhaseRef"
          },
          "ties": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BracketV1Tie"
            },
            "description": "Oppositions du tour, par `position`"
          }
        },
        "required": [
          "phase",
          "ties"
        ],
        "description": "Un tour du tableau : sa phase, dont `name` est le libellé (« 1/8 de finale »)"
      },
      "BracketV1Tie": {
        "type": "object",
        "properties": {
          "position": {
            "type": "integer",
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "Place de l'opposition dans son tour, de haut en bas (1 : la première), dans l'ordre de la source"
          },
          "nextPosition": {
            "type": "integer",
            "nullable": true,
            "minimum": 0,
            "exclusiveMinimum": true,
            "description": "`position` de l'opposition du tour suivant où se retrouve le qualifié : le trait qui relie les deux ; `null` pour le dernier tour, ou tant que le qualifié n'y figure pas"
          },
          "sides": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BracketV1Side"
            },
            "description": "Les deux concurrents, dans l'ordre d'affichage : celui qui reçoit au premier match d'abord"
          },
          "contests": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BracketV1Contest"
            },
            "minItems": 1,
            "description": "Matchs de l'opposition dans l'ordre chronologique : aller et retour, ou un match unique (finale)"
          }
        },
        "required": [
          "position",
          "nextPosition",
          "sides",
          "contests"
        ],
        "description": "Une opposition d'un tour : deux concurrents, leurs matchs, le cumul et le qualifié"
      },
      "BracketV1Side": {
        "type": "object",
        "properties": {
          "competitor": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TeamCompetitor"
              },
              {
                "$ref": "#/components/schemas/PersonCompetitor"
              },
              {
                "$ref": "#/components/schemas/CrewCompetitor"
              },
              {
                "nullable": true
              }
            ],
            "description": "`null` tant qu'il n'est pas connu (tirage à venir, opposition du tour précédent en cours)"
          },
          "scores": {
            "type": "array",
            "items": {
              "type": "number",
              "nullable": true,
              "minimum": 0
            },
            "description": "Son score à chaque match, dans l'ordre de `contests`, prolongations comprises et tirs au but exclus ; `null` pour un match qui n'a pas commencé"
          },
          "aggregate": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "Cumul de ses scores sur les matchs commencés ; `null` tant qu'aucun n'a commencé"
          },
          "shootout": {
            "type": "number",
            "nullable": true,
            "minimum": 0,
            "description": "Tirs au but réussis quand une séance a départagé l'opposition (à afficher entre parenthèses) ; `null` sans séance"
          },
          "qualified": {
            "type": "boolean",
            "description": "Vrai pour le qualifié (le vainqueur pour la finale), à afficher en gras ; faux des deux côtés tant que l'opposition n'est pas tranchée"
          }
        },
        "required": [
          "competitor",
          "scores",
          "aggregate",
          "shootout",
          "qualified"
        ],
        "description": "Un concurrent d'une opposition et ses scores"
      },
      "BracketV1Contest": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Identifiant opaque d'un contest (match, course, épreuve)"
          },
          "startsAt": {
            "type": "string",
            "nullable": true,
            "format": "date-time",
            "description": "Instant ISO 8601 en UTC (`2026-10-10T13:30:00.000Z`)"
          },
          "status": {
            "$ref": "#/components/schemas/ContestStatus"
          },
          "statusLabel": {
            "type": "string",
            "nullable": true
          }
        },
        "required": [
          "id",
          "startsAt",
          "status",
          "statusLabel"
        ],
        "description": "Un match d'une opposition (aller, retour, ou match unique) ; sa fiche est `/v1/contests/{id}`"
      },
      "BracketV1LiveResponse": {
        "type": "object",
        "properties": {
          "data": {
            "$ref": "#/components/schemas/BracketV1Live"
          },
          "meta": {
            "$ref": "#/components/schemas/LiveMeta"
          },
          "links": {
            "$ref": "#/components/schemas/ApiLinks"
          }
        },
        "required": [
          "data",
          "meta",
          "links"
        ]
      },
      "BracketV1Live": {
        "type": "object",
        "properties": {
          "rounds": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/BracketV1Round"
            },
            "description": "Tours du tableau dans l'ordre : la phase demandée, puis chaque phase à élimination qui la suit jusqu'à la finale"
          }
        },
        "required": [
          "rounds"
        ],
        "description": "Ce qui bouge sur le tableau pendant qu'il se joue : ses tours, sous la même forme que le module. Le widget remplace les tours du tableau chargé une fois."
      }
    },
    "parameters": {}
  },
  "paths": {
    "/v1/sports": {
      "get": {
        "tags": [
          "v1 — Référentiels"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`"
            },
            "required": false,
            "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`",
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "example": 20,
              "description": "Taille de la page, de 1 à 100 (défaut : 20)"
            },
            "required": false,
            "description": "Taille de la page, de 1 à 100 (défaut : 20)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Sports, triés par id ; `id` sert de filtre `sport` aux autres routes",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SportsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu, ou curseur invalide",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/competitions": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+(,\\d+){0,99}$",
              "example": "103,302",
              "description": "Compétitions demandées, ids séparés par des virgules (100 max)"
            },
            "required": false,
            "description": "Compétitions demandées, ids séparés par des virgules (100 max)",
            "name": "ids",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Un sport (`id` de /v1/sports)",
              "example": "302"
            },
            "required": false,
            "description": "Un sport (`id` de /v1/sports)",
            "name": "sport",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`"
            },
            "required": false,
            "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`",
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "example": 20,
              "description": "Taille de la page, de 1 à 100 (défaut : 20)"
            },
            "required": false,
            "description": "Taille de la page, de 1 à 100 (défaut : 20)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Compétitions, triées par id, avec leur sport et leur saison courante (point d'entrée de /v1/standings)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompetitionsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu, ou curseur invalide",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/seasons/{id}": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Saison (`currentSeason.id` de /v1/competitions)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Saison et ses phases, chacune avec son `format` et ses poules",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeasonResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/seasons/{id}/medals": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Édition d'une compétition multisport (`currentSeason.id` ou /v1/seasons)",
              "example": "40002"
            },
            "required": true,
            "description": "Édition d'une compétition multisport (`currentSeason.id` ou /v1/seasons)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/MedalSort"
            },
            "required": false,
            "description": "Ordre du tableau : à l'or (puis argent, bronze), usage olympique, ou au total",
            "name": "sort",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Tableau des médailles par pays de la saison",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MedalTableResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue, ou sans médaille",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/seasons/{id}/leaders": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Saison (`currentSeason.id` de /v1/competitions)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "goals",
                "assists",
                "yellow-cards",
                "red-cards"
              ],
              "description": "Statistique classée : buts (hors contre son camp et buts refusés), passes décisives, cartons jaunes, cartons rouges (rouge direct ou deuxième jaune)",
              "example": "goals"
            },
            "required": true,
            "description": "Statistique classée : buts (hors contre son camp et buts refusés), passes décisives, cartons jaunes, cartons rouges (rouge direct ou deuxième jaune)",
            "name": "stat",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "description": "Nombre de joueurs, de 1 à 100 (défaut : 10)"
            },
            "required": false,
            "description": "Nombre de joueurs, de 1 à 100 (défaut : 10)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Les joueurs d'une équipe, sur ses seuls matchs de la saison"
            },
            "required": false,
            "description": "Les joueurs d'une équipe, sur ses seuls matchs de la saison",
            "name": "team",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Classement des joueurs de la saison sur une statistique : buteurs, passeurs, cartons",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeasonLeadersResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue, ou dont les actions de match ne sont pas importées pour presque tous les matchs joués",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/seasons": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une compétition (`id` de /v1/competitions)",
              "example": "103"
            },
            "required": true,
            "description": "Une compétition (`id` de /v1/competitions)",
            "name": "competition",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Saisons de la compétition, de la plus récente à la plus ancienne (non paginé)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeasonListResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/seasons/{id}/days": {
      "get": {
        "tags": [
          "v1 — Compétitions"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Saison (`currentSeason.id` de /v1/competitions)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Journées de la saison : numéro dans la phase, date, matchs joués, journée courante (non paginé)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeasonDaysResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/standings": {
      "get": {
        "tags": [
          "v1 — Classements"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^day:\\d+$",
              "example": "day:6865802",
              "description": "Classement après une journée (`day:<id>`) ; par défaut, la plus récente de chaque poule"
            },
            "required": false,
            "description": "Classement après une journée (`day:<id>`) ; par défaut, la plus récente de chaque poule",
            "name": "after",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/StandingSplit"
            },
            "required": false,
            "description": "Classement général, à domicile ou à l'extérieur",
            "name": "split",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une seule poule ; par défaut, toutes"
            },
            "required": false,
            "description": "Une seule poule ; par défaut, toutes",
            "name": "group",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Classement de la saison ; sa forme dépend de `kind`",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StandingsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue, ou sans classement",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contests": {
      "get": {
        "tags": [
          "v1 — Contests"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": false,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-10",
              "description": "Jour (UTC) : tous les contests du jour, toutes compétitions confondues"
            },
            "required": false,
            "description": "Jour (UTC) : tous les contests du jour, toutes compétitions confondues",
            "name": "date",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Contests d'une équipe"
            },
            "required": false,
            "description": "Contests d'une équipe",
            "name": "team",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Avec `team` : seulement ses confrontations avec cette équipe"
            },
            "required": false,
            "description": "Avec `team` : seulement ses confrontations avec cette équipe",
            "name": "opponent",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une compétition (`id` de /v1/competitions)",
              "example": "103"
            },
            "required": false,
            "description": "Une compétition (`id` de /v1/competitions)",
            "name": "competition",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Un sport (`id` de /v1/sports)",
              "example": "302"
            },
            "required": false,
            "description": "Un sport (`id` de /v1/sports)",
            "name": "sport",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une journée"
            },
            "required": false,
            "description": "Une journée",
            "name": "day",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une phase (id issu de /v1/seasons/{id})"
            },
            "required": false,
            "description": "Une phase (id issu de /v1/seasons/{id})",
            "name": "phase",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une poule (id issu de /v1/seasons/{id})"
            },
            "required": false,
            "description": "Une poule (id issu de /v1/seasons/{id})",
            "name": "group",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/ContestStatusFilter"
            },
            "required": false,
            "description": "Seulement les contests de ce statut",
            "name": "status",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`"
            },
            "required": false,
            "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`",
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "example": 20,
              "description": "Taille de la page, de 1 à 100 (défaut : 20)"
            },
            "required": false,
            "description": "Taille de la page, de 1 à 100 (défaut : 20)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Contests de la saison, par date : duels (`head-to-head`) ou épreuves classées (`ranked`, podium seul)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContestsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant, ou curseur invalide",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contests/{id}": {
      "get": {
        "tags": [
          "v1 — Contests"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Contest",
              "example": "54732603"
            },
            "required": true,
            "description": "Contest",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Contest en détail : périodes (mi-temps, sets), stade, affluence, arbitres ; tous les concurrents d'une épreuve classée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContestDetailResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contests/{id}/lineups": {
      "get": {
        "tags": [
          "v1 — Contests"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Contest",
              "example": "54732603"
            },
            "required": true,
            "description": "Contest",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Compositions : système de jeu, titulaires placés sur le terrain, remplaçants",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContestLineupsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/contests/{id}/actions": {
      "get": {
        "tags": [
          "v1 — Contests"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Contest",
              "example": "54732603"
            },
            "required": true,
            "description": "Contest",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Actions du match dans l'ordre du jeu : buts (buteur, passeur), cartons, remplacements, tirs, fautes, VAR",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ContestActionsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/teams/{id}": {
      "get": {
        "summary": "Fiche d'une équipe",
        "description": "Nom, pays, stade (avec sa capacité) et sport de l'équipe. Données de référentiel, cachées un jour.",
        "tags": [
          "v1 — Équipes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Équipe",
              "example": "7703"
            },
            "required": true,
            "description": "Équipe",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Fiche de l'équipe",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TeamDetailResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Équipe inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/teams/{id}/squad": {
      "get": {
        "summary": "Effectif d'une équipe",
        "description": "Joueurs et encadrement de l'équipe. Avec `season`, tous ceux passés par l'équipe entre la première et la dernière journée de la saison (y compris les départs en cours de saison) ; sans, l'effectif du jour. Une personne passée deux fois par l'équipe sur la période a une entrée par passage.",
        "tags": [
          "v1 — Équipes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Équipe",
              "example": "7703"
            },
            "required": true,
            "description": "Équipe",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Effectif d'une saison ; par défaut, celui du jour",
              "example": "374703"
            },
            "required": false,
            "description": "Effectif d'une saison ; par défaut, celui du jour",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Effectif de l'équipe : les joueurs, puis l'encadrement",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TeamSquadResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Équipe ou saison inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/teams/{id}/form": {
      "get": {
        "tags": [
          "v1 — Équipes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Équipe",
              "example": "7703"
            },
            "required": true,
            "description": "Équipe",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison ; par défaut, toutes",
              "example": "374703"
            },
            "required": false,
            "description": "Une saison ; par défaut, toutes",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 20,
              "description": "Nombre de matchs, de 1 à 20 (défaut : 5)"
            },
            "required": false,
            "description": "Nombre de matchs, de 1 à 20 (défaut : 5)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Derniers matchs terminés de l'équipe, du plus récent au plus ancien",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TeamFormResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Équipe inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/persons/{id}": {
      "get": {
        "summary": "Fiche d'une personne",
        "description": "Identité, naissance, nationalités et mensurations d'un athlète, entraîneur ou arbitre. Données de référentiel, cachées un jour.",
        "tags": [
          "v1 — Personnes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Personne (`person.id` d'un effectif ou d'une composition)",
              "example": "3098901"
            },
            "required": true,
            "description": "Personne (`person.id` d'un effectif ou d'une composition)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Fiche de la personne",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonDetailResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Personne inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/persons/{id}/career": {
      "get": {
        "summary": "Parcours d'une personne",
        "description": "Chaque passage dans une équipe tel que la source le découpe (en général une ligne par saison), toutes équipes et tous sports, avec `current` pour l'engagement en cours.",
        "tags": [
          "v1 — Personnes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Personne (`person.id` d'un effectif ou d'une composition)",
              "example": "3098901"
            },
            "required": true,
            "description": "Personne (`person.id` d'un effectif ou d'une composition)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Parcours de la personne, du plus récent au plus ancien",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonCareerResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Personne inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/persons/{id}/stats": {
      "get": {
        "summary": "Stats d'un joueur sur une saison",
        "description": "Comptées sur les actions de match de la saison, comme `/v1/seasons/{id}/leaders` : servies seulement si presque tous les matchs joués ont leurs actions.",
        "tags": [
          "v1 — Personnes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Personne (`person.id` d'un effectif ou d'une composition)",
              "example": "3098901"
            },
            "required": true,
            "description": "Personne (`person.id` d'un effectif ou d'une composition)",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Saison (`currentSeason.id` de /v1/competitions)",
              "example": "372903"
            },
            "required": true,
            "description": "Saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Buts, passes décisives et cartons du joueur sur la saison",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PersonSeasonStatsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Personne ou saison inconnue, ou saison dont les actions de match ne sont pas importées pour presque tous les matchs joués",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/head-to-head": {
      "get": {
        "tags": [
          "v1 — Équipes"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+,\\d+$",
              "example": "7703,8403",
              "description": "Deux équipes, séparées par une virgule"
            },
            "required": true,
            "description": "Deux équipes, séparées par une virgule",
            "name": "teams",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Bilan des confrontations terminées, toutes saisons confondues",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/HeadToHeadResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Équipe inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/live/contests": {
      "get": {
        "tags": [
          "v1 — Live"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-10",
              "description": "Jour (UTC) : tous les contests du jour, toutes compétitions confondues"
            },
            "required": true,
            "description": "Jour (UTC) : tous les contests du jour, toutes compétitions confondues",
            "name": "date",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Un sport (`id` de /v1/sports)",
              "example": "302"
            },
            "required": false,
            "description": "Un sport (`id` de /v1/sports)",
            "name": "sport",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une compétition (`id` de /v1/competitions)",
              "example": "103"
            },
            "required": false,
            "description": "Une compétition (`id` de /v1/competitions)",
            "name": "competition",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`"
            },
            "required": false,
            "description": "Curseur de la page suivante, tel que renvoyé dans `meta.cursor`",
            "name": "cursor",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 100,
              "example": 20,
              "description": "Taille de la page, de 1 à 100 (défaut : 20)"
            },
            "required": false,
            "description": "Taille de la page, de 1 à 100 (défaut : 20)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Contests du jour réduits au statut et au score (podium pour une épreuve classée). `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiveContestsResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant, ou curseur invalide",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/live/contests/{id}": {
      "get": {
        "tags": [
          "v1 — Live"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Contest",
              "example": "54732603"
            },
            "required": true,
            "description": "Contest",
            "name": "id",
            "in": "path"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Un contest réduit au statut, au score et aux périodes (podium pour une épreuve classée). `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LiveContestResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/v1/search": {
      "get": {
        "summary": "Recherche par nom",
        "description": "Trouve compétitions, équipes et personnes par leur nom, en français ou en anglais, sans tenir compte des accents ni de la casse : le point d'entrée pour passer d'un nom (« PSG », « Mbappé ») à l'id qu'attendent les autres routes. Pas de pagination : `limit` borne le nombre de résultats. Données de référentiel, cachées un jour.",
        "tags": [
          "v1 — Recherche"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "maxLength": 100,
              "example": "paris",
              "description": "Nom cherché, sans tenir compte des accents ni de la casse : chaque mot doit commencer un mot du nom (« mar » trouve Martin, pas Omar), dans n'importe quel ordre (de 1 à 5 mots, dont un d'au moins 3 caractères)"
            },
            "required": true,
            "description": "Nom cherché, sans tenir compte des accents ni de la casse : chaque mot doit commencer un mot du nom (« mar » trouve Martin, pas Omar), dans n'importe quel ordre (de 1 à 5 mots, dont un d'au moins 3 caractères)",
            "name": "q",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "enum": [
                "competition",
                "team",
                "person"
              ],
              "description": "Un seul type d'entité ; par défaut, compétitions, équipes et personnes"
            },
            "required": false,
            "description": "Un seul type d'entité ; par défaut, compétitions, équipes et personnes",
            "name": "type",
            "in": "query"
          },
          {
            "schema": {
              "type": "integer",
              "minimum": 1,
              "maximum": 50,
              "description": "Nombre de résultats, de 1 à 50 (défaut : 10)"
            },
            "required": false,
            "description": "Nombre de résultats, de 1 à 50 (défaut : 10)",
            "name": "limit",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Les entités trouvées, les meilleures d'abord ; liste vide sans résultat",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SearchResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide ou inconnu",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/match-list/v1": {
      "get": {
        "tags": [
          "Modules — MatchList"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Journée affichée ; par défaut, la journée courante"
            },
            "required": false,
            "description": "Journée affichée ; par défaut, la journée courante",
            "name": "day",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget MatchList en un appel : sélecteur de journées et matchs de la journée",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MatchListV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue, ou journée hors de la saison",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/match-list/v1/live": {
      "get": {
        "summary": "Liste de matchs en direct (module MatchList v1)",
        "description": "Relue par le widget pour chaque journée affichée, tant que `meta.pollAfter` n'est pas `null` : les matchs de la journée dans l'ordre du module, au format des vues `/v1/live`. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
        "tags": [
          "Modules — MatchList"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Journée relue",
              "example": "10657303"
            },
            "required": true,
            "description": "Journée relue",
            "name": "day",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Les matchs d'une journée réduits à ce qui bouge (statut, score, heure). `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MatchListV1LiveResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue, ou journée hors de la saison",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/team-sheet/v1": {
      "get": {
        "summary": "Fiche équipe (module TeamSheet v1)",
        "description": "Compose `/v1/teams/{id}`, `/v1/teams/{id}/squad`, `/v1/teams/{id}/form` et le prochain match de `/v1/contests`. Mise en cache le temps de la partie qui bouge le plus vite : le jour d'un match, comme les matchs du jour.",
        "tags": [
          "Modules — TeamSheet"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Équipe",
              "example": "7703"
            },
            "required": true,
            "description": "Équipe",
            "name": "team",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Restreint l'effectif, la forme, le prochain match et les compétitions à une saison ; par défaut, l'effectif du jour, toutes les saisons et les compétitions en cours",
              "example": "374703"
            },
            "required": false,
            "description": "Restreint l'effectif, la forme, le prochain match et les compétitions à une saison ; par défaut, l'effectif du jour, toutes les saisons et les compétitions en cours",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget TeamSheet en un appel : fiche, effectif, forme et prochain match",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TeamSheetV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Équipe ou saison inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/player-card/v1": {
      "get": {
        "summary": "Fiche joueur (module PlayerCard v1)",
        "description": "Compose `/v1/persons/{id}` et `/v1/persons/{id}/career`.",
        "tags": [
          "Modules — PlayerCard"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Personne",
              "example": "3098901"
            },
            "required": true,
            "description": "Personne",
            "name": "person",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget PlayerCard en un appel : identité, engagement en cours et parcours",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PlayerCardV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Personne inconnue",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/match-sheet/v1": {
      "get": {
        "summary": "Feuille de match (module MatchSheet v1)",
        "description": "Compose `/v1/contests/{id}`, ses actions (buts, cartons, remplacements, tirs au but) et ses compositions, le classement de sa poule à la date du match (`/v1/standings`, général, domicile, extérieur), la forme des deux équipes et leurs confrontations avant le match (`/v1/teams/{id}/form`, `/v1/head-to-head`) et leurs joueurs clés sur la saison (`/v1/seasons/{id}/leaders?team=`). Mise en cache le temps de la partie qui bouge le plus vite : le jour du match, comme les matchs du jour.",
        "tags": [
          "Modules — MatchSheet"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Match",
              "example": "54732603"
            },
            "required": true,
            "description": "Match",
            "name": "contest",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget MatchSheet en un appel : en-tête, informations, actions, compositions et avant-match",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MatchSheetV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu, ou qui n'est pas un duel entre deux équipes",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/match-sheet/v1/live": {
      "get": {
        "summary": "Feuille de match en direct (module MatchSheet v1)",
        "description": "Relue par le widget après le chargement de la feuille complète, tant que `meta.pollAfter` n'est pas `null` : en-tête (statut, score, périodes), actions et compositions, sous la même forme que dans `/modules/match-sheet/v1`. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
        "tags": [
          "Modules — MatchSheet"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Match",
              "example": "54732603"
            },
            "required": true,
            "description": "Match",
            "name": "contest",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Ce qui bouge sur la feuille : en-tête, actions et compositions. `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MatchSheetV1LiveResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Contest inconnu, ou qui n'est pas un duel entre deux équipes",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/score-center/v1": {
      "get": {
        "summary": "Score Center (module ScoreCenter v1)",
        "description": "Les matchs d'un sport sur un jour du fuseau du média (Europe/Paris par défaut), groupés par compétition dans l'ordre de `competitions` (à défaut, la liste par défaut du sport), filtrables par statut. `previousDate` et `nextDate` donnent les jours voisins qui ont des matchs : la navigation saute les jours vides. Le classement d'un bloc se lit via `/v1/standings?season=`.",
        "tags": [
          "Modules — ScoreCenter"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Un sport (`id` de /v1/sports)",
              "example": "302"
            },
            "required": true,
            "description": "Un sport (`id` de /v1/sports)",
            "name": "sport",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-18",
              "description": "Jour affiché, dans le fuseau `timeZone` ; par défaut, aujourd'hui"
            },
            "required": false,
            "description": "Jour affiché, dans le fuseau `timeZone` ; par défaut, aujourd'hui",
            "name": "date",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/ScoreCenterV1Status"
            },
            "required": false,
            "description": "Filtre du Score Center : en cours (`live`), terminés (`finished`) ou à venir (`scheduled`) ; sans filtre, tous. Liste fermée : une valeur inconnue est refusée (`400`).",
            "name": "status",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+(,\\d+){0,29}$",
              "example": "103,2003,503",
              "description": "Compétitions affichées, dans l'ordre des blocs (30 max) ; par défaut, la liste du sport définie par l'API"
            },
            "required": false,
            "description": "Compétitions affichées, dans l'ordre des blocs (30 max) ; par défaut, la liste du sport définie par l'API",
            "name": "competitions",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "example": "Europe/Paris",
              "description": "Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris"
            },
            "required": false,
            "description": "Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris",
            "name": "timeZone",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget ScoreCenter en un appel : les matchs du jour groupés par compétition et les jours voisins qui en ont",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScoreCenterV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant, ou `competitions` absent pour un sport sans liste par défaut",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/score-center/v1/live": {
      "get": {
        "summary": "Score Center en direct (module ScoreCenter v1)",
        "description": "Relue par le widget avec les mêmes paramètres que le module, tant que `meta.pollAfter` n'est pas `null` : les matchs du jour dans l'ordre des blocs, au format des vues `/v1/live`. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
        "tags": [
          "Modules — ScoreCenter"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Un sport (`id` de /v1/sports)",
              "example": "302"
            },
            "required": true,
            "description": "Un sport (`id` de /v1/sports)",
            "name": "sport",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "format": "date",
              "example": "2026-10-18",
              "description": "Jour affiché, dans le fuseau `timeZone` ; par défaut, aujourd'hui"
            },
            "required": false,
            "description": "Jour affiché, dans le fuseau `timeZone` ; par défaut, aujourd'hui",
            "name": "date",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/ScoreCenterV1Status"
            },
            "required": false,
            "description": "Filtre du Score Center : en cours (`live`), terminés (`finished`) ou à venir (`scheduled`) ; sans filtre, tous. Liste fermée : une valeur inconnue est refusée (`400`).",
            "name": "status",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "pattern": "^\\d+(,\\d+){0,29}$",
              "example": "103,2003,503",
              "description": "Compétitions affichées, dans l'ordre des blocs (30 max) ; par défaut, la liste du sport définie par l'API"
            },
            "required": false,
            "description": "Compétitions affichées, dans l'ordre des blocs (30 max) ; par défaut, la liste du sport définie par l'API",
            "name": "competitions",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "example": "Europe/Paris",
              "description": "Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris"
            },
            "required": false,
            "description": "Fuseau du média (IANA, casse indifférente), qui borne le jour ; par défaut Europe/Paris",
            "name": "timeZone",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Les matchs du jour réduits à ce qui bouge (statut, score, heure). `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ScoreCenterV1LiveResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant, ou `competitions` absent pour un sport sans liste par défaut",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/bracket/v1": {
      "get": {
        "summary": "Tableau de phase finale (module Bracket v1)",
        "description": "Compose `/v1/seasons/{id}` (ses phases `format: knockout`) et `/v1/contests?season=&phase=` pour chaque tour, de la phase demandée à la finale. Les matchs d'un tour sont regroupés par paire de concurrents en oppositions, placées dans l'ordre de la source (`game_order`) ; le qualifié est celui qui se retrouve au tour suivant, à défaut le vainqueur au cumul puis aux tirs au but. Football.",
        "tags": [
          "Modules — Bracket"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Premier tour du tableau : une phase `format: knockout` de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)",
              "example": "512803"
            },
            "required": true,
            "description": "Premier tour du tableau : une phase `format: knockout` de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)",
            "name": "phase",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Widget Bracket en un appel : tours, oppositions (aller, retour, cumul, tirs au but), qualifiés et place de chaque opposition",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BracketV1Response"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue (`season-not-found`), phase hors de la saison (`phase-not-found`), ou phase qui n'est pas à élimination ou d'un sport sans tableau (`bracket-unavailable`)",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    },
    "/modules/bracket/v1/live": {
      "get": {
        "summary": "Tableau de phase finale en direct (module Bracket v1)",
        "description": "Relue par le widget tant que `meta.pollAfter` n'est pas `null` : scores, cumuls et qualifiés bougent ensemble, le widget remplace ses tours. Tant qu'elle se relit, en cache `pollAfter` secondes dans le navigateur (`Cache-Control: public, max-age=<pollAfter>`) et une minute au CDN, rafraîchie à chaque changement ; ensuite, la classe de son contenu.",
        "tags": [
          "Modules — Bracket"
        ],
        "parameters": [
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Une saison (`currentSeason.id` de /v1/competitions)",
              "example": "374703"
            },
            "required": true,
            "description": "Une saison (`currentSeason.id` de /v1/competitions)",
            "name": "season",
            "in": "query"
          },
          {
            "schema": {
              "type": "string",
              "minLength": 1,
              "pattern": "^\\d+$",
              "description": "Premier tour du tableau : une phase `format: knockout` de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)",
              "example": "512803"
            },
            "required": true,
            "description": "Premier tour du tableau : une phase `format: knockout` de /v1/seasons/{id} (« 1/8 de finale » pour un tableau qui part des 1/8)",
            "name": "phase",
            "in": "query"
          },
          {
            "schema": {
              "$ref": "#/components/schemas/Lang"
            },
            "required": false,
            "description": "Langue des noms, code ISO 639-1. Un nom absent dans cette langue retombe sur l'anglais, puis le français.",
            "name": "lang",
            "in": "query"
          }
        ],
        "responses": {
          "200": {
            "description": "Les tours du tableau, sous la forme du module. `meta.pollAfter` : secondes avant la prochaine lecture, `null` quand plus rien ne bougera.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BracketV1LiveResponse"
                }
              }
            }
          },
          "304": {
            "description": "Contenu inchangé depuis l'ETag envoyé en If-None-Match"
          },
          "400": {
            "description": "Paramètre invalide, inconnu ou manquant",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          },
          "404": {
            "description": "Saison inconnue (`season-not-found`), phase hors de la saison (`phase-not-found`), ou phase qui n'est pas à élimination ou d'un sport sans tableau (`bracket-unavailable`)",
            "content": {
              "application/problem+json": {
                "schema": {
                  "$ref": "#/components/schemas/Problem"
                }
              }
            }
          }
        }
      }
    }
  }
}