Référence générée · v1.0.0

Référence de l'API publique

Générée automatiquement depuis notre spécification OpenAPI — toujours à jour avec les endpoints réellement servis. Importez la spec dans Postman ou votre outil de génération de code.

Base URL : https://www.lacotedazurelympique.frTélécharger la spec OpenAPI (JSON)

Endpoints

post/api/public/scrim-requestsSans auth

Propose un scrim public a une de nos equipes (anti-bot captcha + honeypot).

Corps de la requête

PublicScrimRequestInput

Réponses

Statut	Schéma	Description
201	object	Demande de scrim enregistree.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Equipe cible introuvable.
429	Error	Rate-limit dépassé (par-actor ou par-route).

post/api/public/newsletter/subscribeSans auth

Inscription newsletter (double opt-in) — anti-bot captcha + honeypot.

Enregistre (ou re-arme) un abonne `pending` avec un `confirm_token` aleatoire et envoie l'email de confirmation. Reponse toujours generique `{ success: true }` (enumeration-safe) : ne revele jamais si l'adresse existait deja. Un honeypot rempli est silencieusement absorbe (200).

Corps de la requête

PublicNewsletterSubscribeInput

Réponses

Statut	Schéma	Description
200	object	Toujours renvoye tant que la requete est bien formee (succes generique).
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
429	Error	Rate-limit dépassé (par-actor ou par-route).

get/api/public/newsletter/confirmSans auth

Confirme une inscription newsletter (double opt-in) via le lien email.

Cible du lien de confirmation. Passe l'abonne a `confirmed` puis redirige (302) vers `/newsletter/merci`. Token manquant / invalide / introuvable → redirige vers `/newsletter/merci?status=invalid`. Pas de captcha (clic sur un lien).

Paramètres

Paramètre	Emplacement	Type	Description
`token`requis	requête	string	Le `confirm_token` recu par email.

Réponses

Statut	Schéma	Description
302	—	Redirection vers la page de remerciement (ou `?status=invalid`).

get/api/public/openapiSans auth

Spécification OpenAPI publique (machine-readable).

Spec OpenAPI 3.1 filtrée à la surface publique (`/api/public/*`), dérivée de la spec canonique `docs/openapi.yaml`. Anonyme, CORS `*`, rate-limitée (120 req/min/IP). `?format=yaml` pour la variante YAML. À importer dans Postman / un générateur de code.

Paramètres

Paramètre	Emplacement	Type	Description
`format`	requête	enum(`json` \| `yaml`)

Réponses

Statut	Schéma	Description
200	object	Document OpenAPI (JSON par défaut, YAML si demandé).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/webhook-eventsSans auth

Catalogue public des types d'événements webhook souscriptibles.

Catalogue anonyme des event types qu'un tenant peut recevoir en webhook sortant, + la convention de signature. Dérivé du sous-ensemble PUBLIC des noms d'événements outbox (les événements Discord internes n'y figurent jamais). Anonyme, CORS `*`, edge-caché (`s-maxage=3600`).

Réponses

Statut	Schéma	Description
200	object	Catalogue d'événements + convention de signature.
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/tournamentsSans auth

Liste des tournois publics (published/running/completed).

Paramètres

Paramètre	Emplacement	Type
`status`	requête	enum(`published` \| `running` \| `completed`)
`game`	requête	string
`limit`	requête	integer
`offset`	requête	integer

Réponses

Statut	Schéma	Description
200	object	Page de tournois publics + pagination.
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/tournaments/{id}Sans auth

Détail d'un tournoi public + résumé des stages.

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string	Id (UUID) ou slug du tournoi.

Réponses

Statut	Schéma	Description
200	object	Détail tournoi.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/tournaments/{id}/matchesSans auth

Matches d'un tournoi (overlays de bracket).

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string	Id (UUID) ou slug du tournoi.
`stageId`	requête	string
`status`	requête	enum(`pending` \| `ongoing` \| `finished`)

Réponses

Statut	Schéma	Description
200	object	Liste des matches publics du tournoi.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/tournaments/{id}/standingsSans auth

Classement final du tournoi (vide si non finalisé).

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string	Id (UUID) ou slug du tournoi.

Réponses

Statut	Schéma	Description
200	object	Classement final trié par rank.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/tournaments/{id}/arbitrationSans auth

Métriques d'arbitrage agrégées (non-nominatives) du tournoi.

Agrégat de l'activité d'arbitrage (litiges) d'un tournoi public : volume, résolution, respect du SLA, répartition des litiges ouverts. AUCUN identifiant ni raison — que des nombres. 404 si le tournoi n'est pas public (draft / archived / inconnu).

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string	Id (UUID) ou slug du tournoi.

Réponses

Statut	Schéma	Description
200	object	Métriques d'arbitrage agrégées du tournoi.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

post/api/public/v1/matches/{id}/resultToken requis

Pose le score final d'un match (écriture publique authentifiée).

Écriture publique autoritaire (pas de consensus capitaine) — réutilise `applyMatchScore`. Idempotent (`Idempotency-Key`). Requiert le scope `matches:write`.

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string <uuid>	Id (UUID) du match.

Corps de la requête

Propriété	Type	Description
`team1Score`requis	integer
`team2Score`requis	integer

Réponses

Statut	Schéma	Description
200	object	Match finalisé.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
401	Error	Auth manquante ou invalide (clé, session ou bearer).
403	Error	Authentifié mais rôle/permissions insuffisants.
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
409	Error	État incompatible (idempotency mismatch, lock détenu).
429	Error	Rate-limit dépassé (par-actor ou par-route).

get/api/public/v1/matches/{id}Sans auth

Détail d'un match public + games (map par map).

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string <uuid>	Id (UUID) du match.

Réponses

Statut	Schéma	Description
200	object	Détail match.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/teams/{id}Sans auth

Équipe publique + roster public (sans données privées).

Paramètres

Paramètre	Emplacement	Type	Description
`id`requis	chemin	string	Id (UUID) ou slug de l'équipe.

Réponses

Statut	Schéma	Description
200	object	Détail équipe.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/leaderboardSans auth

Classement Glicko-2 public des joueuses.

Paramètres

Paramètre	Emplacement	Type	Description
`limit`	requête	integer
`offset`	requête	integer

Réponses

Statut	Schéma	Description
200	object	Page du classement + pagination.
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/players/{userId}Sans auth

Profil public d'une joueuse (rating, historique, H2H, achievements).

Paramètres

Paramètre	Emplacement	Type	Description
`userId`requis	chemin	string <uuid>	Id (UUID) de la joueuse.

Réponses

Statut	Schéma	Description
200	object	Profil joueur.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/leaguesSans auth

Liste des leagues publiques.

Réponses

Statut	Schéma	Description
200	object	Leagues publiques.
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

get/api/public/v1/leagues/{slug}Sans auth

Détail public d'une league (standings + tournois liés).

Paramètres

Paramètre	Emplacement	Type	Description
`slug`requis	chemin	string

Réponses

Statut	Schéma	Description
200	object	Détail league.
400	Error	Requête invalide (validation zod, JSON mal formé, etc.).
404	Error	Ressource introuvable (UUID inconnu, route inexistante).
429	Error	Rate-limit dépassé (par-actor ou par-route).
500	Error	Erreur serveur non récupérable.

Schémas

Error

Propriété	Type	Description
`error`requis	string	Message lisible côté client.
`code`	string	Code machine (ex. `MISSING_TENANT_ID`, `UNKNOWN_TENANT`).
`details`	object

PublicScrimRequestInput

Propriété	Type	Description
`targetTeamId`	string <uuid>
`targetTeamSlug`	string
`fromTeamName`	string
`requesterName`requis	string
`requesterEmail`	string <email>
`requesterDiscord`	string
`preferredDate`	string <date-time>
`format`	string
`message`requis	string
`honeypot`	string	Doit etre vide (anti-bot).
`captchaToken`	string
`captchaAnswer`	string

PublicNewsletterSubscribeInput

Propriété	Type	Description
`email`requis	string <email>
`source`	string	Provenance libre (ex. `footer`, `landing`). Defaut `public`.
`honeypot`	string	Doit etre vide (anti-bot).
`captchaToken`	string
`captchaAnswer`	string

LeaderboardPlayer

Propriété	Type	Description
`userId`requis	string
`displayName`	string \| null
`battleTag`	string \| null
`avatarUrl`	string \| null
`rating`requis	number
`rd`requis	number
`gamesPlayed`requis	integer
`wins`requis	integer
`losses`requis	integer
`rank`requis	integer

PlayerProfileResponse

Propriété	Type	Description
`player`requis	object
`history`requis	array<object>
`recentMatches`requis	array<object>
`h2h`requis	array<object>
`achievements`requis	object	Badges, palmarès (placements en tournoi) et historique de saison dérivés du parcours du joueur par le réducteur pur utils/profile/achievements.ts. Toujours présent (bloc vide si rien à agréger).

League

Propriété	Type	Description
`id`requis	string <uuid>
`tenant_id`requis	string <uuid>
`name`requis	string
`slug`requis	string
`description`	string \| null
`game`	string \| null
`status`requis	enum(`draft` \| `active` \| `finished` \| `archived`)
`start_date`	string \| null
`end_date`	string \| null
`points_table`requis	object
`is_public`requis	boolean
`created_at`	string
`updated_at`	string

LeagueDetailResponse

Propriété	Type	Description
`league`requis	League
`standings`requis	array<object>
`tournaments`requis	array<object>

PublicV1Pagination

Propriété	Type	Description
`limit`requis	integer
`offset`requis	integer
`count`requis	integer	Nombre total d'éléments avant pagination (tournois) ou nombre d'éléments retournés dans la page (leaderboard).

PublicV1TournamentSummary

Propriété	Type	Description
`id`requis	string <uuid>
`name`requis	string
`slug`	string \| null
`game`	string \| null
`status`requis	string
`start_date`	string \| null
`end_date`	string \| null
`format`	string \| null

PublicV1StageSummary

Propriété	Type	Description
`id`requis	string <uuid>
`name`	string \| null
`stage_type`	string \| null
`status`requis	string	Dérivé de `is_active` (active \| inactive).

PublicV1TournamentDetail

any

PublicV1Match

Propriété	Type	Description
`id`requis	string <uuid>
`stage_id`	string \| null
`round_number`	integer \| null
`bracket_side`	string \| null
`team1_id`	string \| null
`team1_name`	string \| null
`team1_logo_url`	string \| null	Public team logo URL (may be null).
`team2_id`	string \| null
`team2_name`	string \| null
`team2_logo_url`	string \| null	Public team logo URL (may be null).
`team1_score`	integer \| null
`team2_score`	integer \| null
`winner_team_id`	string \| null
`status`requis	string
`scheduled_at`	string \| null

PublicV1MatchGame

Propriété	Type	Description
`map_name`	string \| null
`map_order`	integer \| null
`team1_score`	integer \| null
`team2_score`	integer \| null
`winner_team_id`	string \| null

PublicV1MatchDetail

any

PublicV1Standing

Propriété	Type	Description
`rank`requis	integer
`teamId`requis	string <uuid>
`teamName`	string \| null
`teamSlug`	string \| null
`logoUrl`	string \| null
`prize`	string \| null

PublicV1ArbitrationMetrics

Métriques d'arbitrage AGRÉGÉES et NON-NOMINATIVES d'un tournoi. Aucun identifiant (équipe / match / joueur), aucune raison de litige : que des compteurs, durées et taux.

Propriété	Type	Description
`totalDisputes`requis	integer	Matchs ayant eu un litige (opened_at set OU status=disputed OU résolus).
`open`requis	integer	Litiges non résolus (status=disputed).
`resolved`requis	integer	Litiges avec un timestamp de résolution.
`avgResolutionMinutes`	integer \| null	Temps moyen de résolution (minutes) sur les résolus ; null si aucun.
`medianResolutionMinutes`	integer \| null	Temps médian de résolution (minutes) sur les résolus ; null si aucun.
`withinSlaCount`requis	integer	Litiges résolus dans le SLA (durée <= slaMinutes).
`slaComplianceRate`	number \| null	withinSlaCount / resolved (0..1) ; null si resolved=0.
`openBreakdown`requis	object	Répartition SLA des litiges OUVERTS.
`slaMinutes`requis	integer	Fenêtre SLA (minutes) du tenant utilisée pour le calcul.

PublicV1TournamentArbitration

Propriété	Type	Description
`tournamentId`requis	string <uuid>
`tournamentName`requis	string
`tournamentSlug`	string \| null
`metrics`requis	PublicV1ArbitrationMetrics

PublicV1TeamMember

Propriété	Type	Description
`display_name`	string \| null
`role`	string \| null
`is_substitute`	boolean

PublicV1Team

Propriété	Type	Description
`id`requis	string <uuid>
`name`requis	string
`short_name`	string \| null
`slug`	string \| null
`logo_url`	string \| null
`roster`requis	array<PublicV1TeamMember>

Cette page est générée depuis docs/openapi.yaml à chaque déploiement — elle ne peut pas dériver du comportement réel de l'API.