Ir al contenido principal
Petanque Life
Portal de desarrolladores

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 docs

Autenticación

Tokens JWT ES512, flujos OAuth2, credenciales M2M.

Próximamente

Webhooks

Notificaciones en tiempo real de eventos de la plataforma.

Próximamente

SDKs y bibliotecas

Bibliotecas cliente oficiales para Python, TypeScript/JavaScript y .NET.

Próximamente

Límites de velocidad

Límites, cuotas y mejores prácticas de uso.

Próximamente

Manejo de errores

Respuestas de error estandarizadas y solución de problemas.

Próximamente

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

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.

¿Listo para construir?

Obtén tus credenciales API y empieza a integrar hoy.