Zéro Erreur de Type
Validation Pydantic v2 complète. Plus de 60 modèles garantissant des autocomplétions parfaites dans votre IDE. Dites adieu aux KeyError.
Les données FFBB.
Maintenant accessibles.
La refonte totale pour remplacer l'ancienne V2 obsolète. Ne gérez plus les tokens à la main. Découvrez le SDK Python asynchrone, 100% type-safe via Pydantic v2 et prêt pour la production.
$ pip install ffbb_data_client
Explorer le code
Oubliez les dict bruts.
Un SDK conçu pour le confort des développeurs, l'intégrité de la donnée et l'efficience.
Meilisearch Multi-Index
Un seul appel réseau pour interroger 9 index (Clubs, Rencontres, Terrains, Salles...). Filtres filter, sort, limit natifs intégrés.
Async First & Cache
Conçu pour FastAPI et les charges intenses. Routines asynchrones (`async/await`) et cache HTTP automatique optimisé via Hishel.
Prêt pour les Agents IA
Compatible nativement avec le standard MCP. ffbb-data-client propulse le serveur officiel FFBB MCP Server pour Claude, Cursor et Copilot.
example.py
from ffbb_data_client import FFBBDataClient, TokenManager
import asyncio
# Les tokens publics FFBB sont générés & renouvelés automatiquement
tokens = TokenManager.get_tokens()
client = FFBBDataClient.create(
api_bearer_token=tokens.api_token,
meilisearch_bearer_token=tokens.meilisearch_token,
)
async def detect_talents():
# Retourne des objets typés (Models Pydantic), fini les dicts !
clubs = await client.search_organismes_async("Pau")
print(f"Club trouvé : {clubs.hits[0].nom}")
# Recherche ultra rapide avec filtre MeiliSearch natif
comps = await client.search_competitions_async(
"Pro A", sort=["libelle:asc"], limit=5
)
asyncio.run(detect_talents())L'expérience développeur ultime
Créer un script ne prend plus que 30 secondes. Ne perdez plus de temps à faire la rétro-ingénierie des endpoints, nous l'avons fait pour vous.
- ✔️ Autocomplétion (IntelliSense)
- ✔️ Gestion des erreurs HTTP packagée
- ✔️ Support complet des matchs en direct (Lives)