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 FFBB expose des APIs modernes, mais personne n'avait fait le SDK. Ne gérez plus les tokens manuellement. Découvrez le client Python asynchrone, type-safe via Pydantic et 100% prêt pour la production.
$ pip install ffbb_api_client_v3
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. FFBBApiClientV3 propulse le serveur officiel FFBB MCP Server pour Claude, Cursor et Copilot.
example.py
from ffbb_api_client_v3 import FFBBAPIClientV3, TokenManager
import asyncio
# Les tokens publics FFBB sont générés & renouvelés automatiquement
tokens = TokenManager.get_tokens()
client = FFBBAPIClientV3.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)