Aller au contenu principal
Petanque Life
Portail développeur

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 doc

Authentification

Tokens JWT ES512, flux OAuth2, identifiants M2M et authentification multi-tenant.

Bientôt disponible

Webhooks

Notifications en temps réel pour les événements de la plateforme.

Bientôt disponible

SDKs & bibliothèques

Bibliothèques client officielles pour Python, TypeScript/JavaScript et .NET.

Bientôt disponible

Limites de débit

Limites, quotas et bonnes pratiques pour une utilisation efficace.

Bientôt disponible

Gestion des erreurs

Réponses d'erreur standardisées, codes HTTP et dépannage.

Bientôt disponible

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

Paid data products

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.