Construye sobre Petanque Life
Integra tus sistemas con la plataforma Petanque Life a través de nuestra API RESTful.
Inicio rápido
1. Obtén tus credenciales API
Solicita credenciales M2M a tu administrador de federación.
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. Haz tu primera solicitud
Usa tu token de acceso para consultar la API.
curl https://api.petanque.life/v1/competitions \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "X-Tenant-ID: YOUR_TENANT_ID" 3. Explora la respuesta
Las respuestas siguen un formato consistente con paginación por cursor.
{
"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
}
} Referencia API
Referencia API REST
Documentación OpenAPI interactiva con ejemplos.
Abrir docsAutenticación
Tokens JWT ES512, flujos OAuth2, credenciales M2M.
PróximamenteWebhooks
Notificaciones en tiempo real de eventos de la plataforma.
PróximamenteSDKs y bibliotecas
Bibliotecas cliente oficiales para Python, TypeScript/JavaScript y .NET.
PróximamenteLímites de velocidad
Límites, cuotas y mejores prácticas de uso.
PróximamenteManejo de errores
Respuestas de error estandarizadas y solución de problemas.
PróximamenteConceptos clave
Arquitectura multi-tenant
Cada solicitud API está vinculada a un tenant. Los datos están aislados.
Autenticación y autorización
La API usa tokens JWT ES512. Tokens de usuario vía OAuth2, tokens M2M vía client credentials.
Paginación por cursor
Los endpoints de lista usan paginación por cursor. Tamaño predeterminado 25, máximo 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.
¿Listo para construir?
Obtén tus credenciales API y empieza a integrar hoy.