Fédération Française de Football – Documentation API (DOFA)

Base URL : https://api-dofa.fff.fr

Bienvenue ! Ci-dessous une version plus lisible et « friendly » de la documentation :

  • Une table des matières compacte pour accéder rapidement aux sections.
  • Des résumés courts par section.
  • Les endpoints sont regroupés dans des blocs pliables (<details/summary>) afin de réduire le scrolling.

Note : le contenu reste une synthèse — certains endpoints peuvent accepter des filtres/pagination non listés ici.

Sommaire rapide

  • Arbitres · Clubs · Équipes · Matchs
  • Phases · Poules · Classements
  • Feuilles de match · Membres · Officiels

Vous pouvez cliquer sur une section pour voir les endpoints et leurs descriptions.

Arbitres

Courte description : liste et fiche détaillée des arbitres.

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/arbitres | Récupère la collection d'arbitres (souvent paginée). | | GET | /api/arbitres/{inNo} | Récupère un arbitre par son identifiant inNo. |

Catégories officielles d'arbitres

Courte description : listes des catégories/grades officiels.

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/arbitre_officiel_categories | Récupère les catégories d'arbitres officielles. | | GET | /api/arbitre_officiel_categories/{id} | Récupère une catégorie par son id. |

Bilans saisonniers

Synthèse calculée des saisons.

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/calcul_bilan_saisons | Récupère les bilans de saison (collection). | | GET | /api/calcul_bilan_saisons/{id} | Récupère un bilan saisonnier spécifique. |

Historique matchs / Séries en cours

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/calcul_match_histos | Récupère historiques calculés des matchs. | | GET | /api/calcul_match_histos/{id} | Détail d'un historique. | | GET | /api/calcul_serie_cours | Récupère les séries en cours. | | GET | /api/calcul_serie_cours/{id} | Détail d'une série. |

Centres de gestion (CDG)

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/cdgs | Liste des CDG. | | GET | /api/cdgs/{cgNo} | Détail d'un CDG. |

Classements par journée

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/compets/{cpNo}/phases/{phases}/poules/{poules}/classement_journees | Classement par journée pour une poule. |

Clubs

Informations générales sur les clubs et lien vers leurs équipes.

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/clubs | Récupère la collection de clubs. | | GET | /api/clubs/{clNo} | Récupère un club par clNo. | | GET | /api/clubs/{clNo}/equipes | Récupère les équipes d'un club. |

Compétitions et Phases

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/compets | Récupère les compétitions. | | GET | /api/compets/{cpNo} | Détail d'une compétition. | | GET | /api/compets/{cpNo}/phases | Récupère les phases d'une compétition. | | GET | /api/compets/{cpNo}/phases/{phases}/poules | Récupère les poules d'une phase. |

Dossiers administratifs

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/dossiers | Récupère la collection de dossiers. | | GET | /api/dossiers/{dsNo} | Récupère un dossier par dsNo. |

Engagements (inscriptions)

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/engagements | Récupère la collection d'engagements. | | GET | /api/clubs/{clNo}/equipes/{equipes}/engagements | Récupère les engagements d'une équipe. |

Équipes

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/clubs/{clNo}/equipes | Récupère les équipes d'un club. | | GET | /api/clubs/{clNo}/equipes/{equipes}/engagements | Engagements d'une équipe. | | GET | /api/clubs/{clNo}/equipes/{equipes}/matchs | Matchs d'une équipe. |

Individus

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/individus/{inNo} | Récupère un individu (joueur, dirigeant, officiel). |

Matchs, calendriers et résultats

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/match_entities | Récupère la collection des objets match. | | GET | /api/match_entities/{maNo} | Récupère un match par maNo. | | GET | /api/clubs/{clNo}/matchs | Matchs d'un club. | | GET | /api/clubs/{clNo}/calendrier | Calendrier d'un club. | | GET | /api/clubs/{clNo}/resultat | Résultats d'un club. | | GET | /api/compets/{cpNo}/phases/{phNo}/poules/{gpNo}/matchs | Matchs d'une poule. | | GET | /api/compets/{cpNo}/phases/{phNo}/poules/{gpNo}/resultat | Résultats d'une poule. | | GET | /api/compets/{cpNo}/phases/{phNo}/poules/{gpNo}/calendrier | Calendrier d'une poule. |

Feuilles de match

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/match_feuilles | Récupère toutes les feuilles de match. | | GET | /api/match_feuilles/{cfmNo} | Récupère une feuille par cfmNo. |

Membres de match

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/match_membres | Récupère la collection de membres (joueurs, officiels présents sur feuille). |

Catégories d'officiels

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/officiel_categories | Liste des catégories d'officiels. | | GET | /api/officiel_categories/{id} | Détail d'une catégorie d'officiel. |

Phases & Poules

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/phases | Récupère toutes les phases. | | GET | /api/compets/{cpNo}/phases | Phases d'une compétition. | | GET | /api/compets/{cpNo}/phases/{phases}/poules | Poules d'une phase. | | GET | /api/compets/{cpNo}/phases/{phases}/poules/{poules}/poule_journees | Journées d'une poule. |

Conseils courts

  • Vérifiez la pagination pour les collections.
  • Testez les filtres saison, clNo, from/to si utiles.
  • Gérez les erreurs HTTP et le CORS côté navigateur.

Si vous voulez, j'ajoute : exemples JSON de réponses, snippets TypeScript/Node, ou une section erreurs communes.

LinkedIn