Hoppa till huvudinnehåll
Petanque Life
Utvecklarportal

Bygg på Petanque Life

Integrera dina system med Petanque Life-plattformen via vårt RESTful API.

Snabbstart

1. Skaffa dina API-uppgifter

Begär M2M-uppgifter från din förbundsadministratör.

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. Gör din första förfrågan

Använd din åtkomsttoken för att fråga API:et.

curl https://api.petanque.life/v1/competitions \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "X-Tenant-ID: YOUR_TENANT_ID"

3. Utforska svaret

Svar följer ett konsekvent format med markörbaserad paginering.

{
  "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
  }
}

API-referens

REST API-referens

Interaktiv OpenAPI-dokumentation med exempel.

Öppna docs

Autentisering

JWT ES512-tokens, OAuth2-flöden, M2M-uppgifter.

Kommer snart

Webhooks

Realtidsnotifikationer för plattformshändelser.

Kommer snart

SDK:er & bibliotek

Officiella klientbibliotek för Python, TypeScript/JavaScript och .NET.

Kommer snart

Hastighetsbegränsningar

Begränsningar, kvoter och bästa praxis.

Kommer snart

Felhantering

Standardiserade felsvar och felsökning.

Kommer snart

Nyckelkoncept

Multi-tenant-arkitektur

Varje API-förfrågan är kopplad till en tenant. Data är helt isolerade.

Autentisering & auktorisering

API:et använder JWT ES512-tokens. Användartoken via OAuth2, M2M-token via client credentials.

Markörbaserad paginering

Listendpoints använder markörbaserad paginering. Standardstorlek 25, max 100.

Betalda dataprodukter

Pétanque-data, serverat som API:er

Auktoritativa feeds för tillsyn, forskning, försäkring och analytics. Alla fyra produkter delar samma OAuth client-credentials-gateway, signerade payloads och versionerade schema-kontrakt.

Integrity-feed

Spelbolag · tillsynsmyndigheter

Realtids-tävlingsevent, sanktioner och licens-behörighet — ed25519-signerad, replay-säker, med SSE-streaming och 30-sekunders eligibility-cache.

Research-API

Universitet · idrottsvetenskapliga institut

Anonymiserade kohorter med k=5 cellsuppression, etik-godkännande-flöde, dataset-versionering och consent-version per post.

Försäkrings-snapshots

Underwriters · mäklare

Månads- och kvartalsaggregerade exponerings-snapshots — NUTS-2-region-granularitet, väderdata-join, oföränderlig efter freeze.

GraphQL-analytics

BI-team · partner-plattformar

Federation-bred analytics över ett typed GraphQL-schema. Per-tier query-complexity-budget, field-level scope-gating, full schema-introspection.

Redo att bygga?

Skaffa API-uppgifter och börja integrera idag.