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 docsAutentisering
JWT ES512-tokens, OAuth2-flöden, M2M-uppgifter.
Kommer snartWebhooks
Realtidsnotifikationer för plattformshändelser.
Kommer snartSDK:er & bibliotek
Officiella klientbibliotek för Python, TypeScript/JavaScript och .NET.
Kommer snartHastighetsbegränsningar
Begränsningar, kvoter och bästa praxis.
Kommer snartFelhantering
Standardiserade felsvar och felsökning.
Kommer snartNyckelkoncept
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.
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.