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 · Terrains

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. |

URL à tester :

  • Collection : https://api-dofa.fff.fr/api/arbitres?saison=2025
  • Détail : https://api-dofa.fff.fr/api/arbitres/75189611

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. |

URL à tester : https://api-dofa.fff.fr/api/arbitre_officiel_categories

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. |

URL à tester : https://api-dofa.fff.fr/api/calcul_bilan_saisons?saison=2025

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. |

URL à tester : https://api-dofa.fff.fr/api/calcul_match_histos?saison=2025

Centres de gestion (CDG)

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

URL à tester :

  • Collection : https://api-dofa.fff.fr/api/cdgs
  • Détail : https://api-dofa.fff.fr/api/cdgs/127

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. |

URL à tester : https://api-dofa.fff.fr/api/compets/453837/phases/1/poules/4/classement_journees?saison=2025

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. |

URL à tester :

  • Collection : https://api-dofa.fff.fr/api/clubs?saison=2025
  • Détail : https://api-dofa.fff.fr/api/clubs/222

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. |

URL à tester :

  • Collection : https://api-dofa.fff.fr/api/compets?saison=2025
  • Détail : https://api-dofa.fff.fr/api/compets/453837

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. |

URL à tester : https://api-dofa.fff.fr/api/dossiers?saison=2025

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. |

URL à tester : https://api-dofa.fff.fr/api/clubs/222/equipes/1/engagements?saison=2025

É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. |

URL à tester :

  • Club : https://api-dofa.fff.fr/api/clubs/222/equipes
  • Équipe : https://api-dofa.fff.fr/api/clubs/222/equipes/1

Individus

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

URL à tester : https://api-dofa.fff.fr/api/individus/75189611

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/clubs/{clNo}/equipes/{eqNo}/calendrier | Calendrier d'une équipe. | | GET | /api/clubs/{clNo}/equipes/{eqNo}/resultat | Résultats d'une équipe. | | 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. |

URL à tester :

  • Collection : https://api-dofa.fff.fr/api/match_entities?saison=2025
  • Détail : https://api-dofa.fff.fr/api/match_entities/79287562
  • Club : https://api-dofa.fff.fr/api/clubs/222/matchs?saison=2025

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. |

URL à tester : https://api-dofa.fff.fr/api/match_feuilles?saison=2025

Membres de match

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

URL à tester : https://api-dofa.fff.fr/api/match_membres?saison=2025

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. |

URL à tester : https://api-dofa.fff.fr/api/officiel_categories

Terrains

| Méthode | Endpoint | Description | |--------:|---------:|:-----------| | GET | /api/terrains/{teNo} | Récupère un terrain par teNo. |

URL à tester : https://api-dofa.fff.fr/api/terrains/692660601

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. |

URL à tester :

  • Phases d'une compétition : https://api-dofa.fff.fr/api/compets/453837/phases
  • Poules d'une phase : https://api-dofa.fff.fr/api/compets/453837/phases/1/poules
  • Journées : https://api-dofa.fff.fr/api/compets/453837/phases/1/poules/4/poule_journees

Client Python api-client-fff

Un client Python généré automatiquement via Swagger est disponible sur PyPI : api-client-fff (v0.1.5, licence LGPLv3+, auteur Thibault Falque). Il requiert Python ≥ 3.10 et aucune authentification n'est nécessaire pour les endpoints.

Installation :

pip install api-client-fff

Exemple d'utilisation :

import apifff
from apifff.rest import ApiException
from pprint import pprint
 
# Collection d'arbitres (paginée)
api = apifff.ArbitreApi(apifff.ApiClient(apifff.Configuration()))
try:
    pprint(api.get_arbitre_collection(page=1))
except ApiException as e:
    print("Exception: %s" % e)
 
# Fiche arbitre par identifiant
try:
    pprint(api.get_arbitre_item(in_no="..."))
except ApiException as e:
    print("Exception: %s" % e)

Tous les endpoints listés ci-dessus exposent une classe *Api correspondante (par ex. ClubApi, MatchEntityApi, TerrainApi) avec des méthodes get_*_collection / get_*_item.

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