Construisez sur Petanque Life
Intégrez vos systèmes avec la plateforme Petanque Life via notre API RESTful.
Démarrage rapide
1. Obtenez vos identifiants API
Demandez des identifiants M2M à votre administrateur de fédération.
curl -X POST https://api.petanque.life/auth/token \
-H "Content-Type: application/json" \
-d '{"client_id": "YOUR_CLIENT_ID", "client_secret": "YOUR_SECRET"}' 2. Faites votre première requête
Utilisez votre token d'accès pour interroger l'API.
curl https://api.petanque.life/v1/competitions \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "X-Tenant-ID: YOUR_TENANT_ID" 3. Explorez la réponse
Les réponses suivent un format cohérent avec pagination par curseur.
{
"data": [
{
"id": "comp_abc123",
"name": "Regional Championship 2026",
"format": "swiss",
"status": "registration_open",
"start_date": "2026-05-15T09:00:00Z"
}
],
"pagination": {
"cursor": "eyJpZCI6ImNvbXBfYWJjMTIzIn0=",
"has_more": true
}
} Référence API
Référence API REST
Documentation OpenAPI interactive avec exemples pour chaque endpoint.
Ouvrir la docAuthentification
Tokens JWT ES512, flux OAuth2, identifiants M2M et authentification multi-tenant.
Bientôt disponibleWebhooks
Notifications en temps réel pour les événements de la plateforme.
Bientôt disponibleSDKs & bibliothèques
Bibliothèques client officielles pour Python, TypeScript/JavaScript et .NET.
Bientôt disponibleLimites de débit
Limites, quotas et bonnes pratiques pour une utilisation efficace.
Bientôt disponibleGestion des erreurs
Réponses d'erreur standardisées, codes HTTP et dépannage.
Bientôt disponibleConcepts clés
Architecture multi-tenant
Chaque requête API est liée à un tenant. Les données sont isolées entre tenants.
Authentification & autorisation
L'API utilise des tokens JWT ES512. Tokens utilisateur via OAuth2, tokens M2M via client credentials.
Pagination par curseur
Les endpoints de liste utilisent la pagination par curseur. Taille par défaut 25, maximum 100.
Petanque data, served as APIs
Authoritative feeds for regulators, researchers, insurers and analytics teams. All four products share one OAuth client-credentials gateway, signed payloads and a versioned schema contract.
Integrity feed
Betting operators · regulators
Real-time competition events, sanctions and license eligibility — ed25519-signed, replay-safe, with SSE streaming and 30-second eligibility cache.
Research API
Universities · sport-science institutes
Anonymised cohorts with k=5 cell suppression, ethics-committee approval workflow, dataset versioning and consent-version per record.
Insurance snapshots
Underwriters · brokers
Monthly and quarterly aggregated exposure snapshots — NUTS-2 region granularity, weather joins, immutable once frozen.
GraphQL analytics
BI teams · partner platforms
Federation-wide analytics over a typed GraphQL schema. Per-tier query complexity budget, field-level scope gating, full schema introspection.
Prêt à construire ?
Obtenez vos identifiants API et commencez à intégrer dès aujourd'hui.