Playtomic Club API ger klubbägare möjlighet att sömlöst integrera sina bokningsdata med externa system, vilket effektiviserar verksamheten och förbättrar medlemsupplevelsen. Denna omfattande guide täcker allt du behöver veta om att få tillgång till och använda vår API.

Vad är Playtomic Club API?

Playtomic Club API är ett säkert, skrivskyddat gränssnitt som tillåter klubbar att programmässigt få tillgång till sina bokningsdata. Oavsett om du driver en enda plats eller hanterar flera anläggningar, gör API:et det möjligt för dig att:

• Integrera med befintliga system som CRM, marknadsföringsverktyg, lojalitetsplattformar eller anläggningshanteringsprogram
• Få tillgång till realtids- och historiska bokningsdata för de senaste 3 månaderna
• Automatisera datasynkronisering för att effektivisera klubbverksamheten

• Förbättra medlemskommunikation genom externa verktyg och plattformar

   

  📋 Notering för Syltek-klubbar: Du kan använda API:et med samma datavisning som i Manager. Medan bokningar synkroniseras från Syltek, observera att inte alla schemaläggningselement (som klasser) kan synkroniseras.

Vem kan få tillgång till API:et?

API-åtkomst är tillgänglig för:

• Klubbar med en enda plats med Champion- eller Master-abonnemangsplaner
• Flerplatsklubbar där varje hyresgäst har Champion- eller Master-abonnemang
• Kedjeägare som får enhetlig tillgång till all klubbdata inom sin organisation

Nuvarande API-funktioner

Vår skrivskyddade API ger tillgång till omfattande bokningsdata, inklusive:

• Boknings-ID och tidsstämplar (UTC-format)
• Bana information (ID, namn)
• Spelardetaljer (ID, e-post, kommunikationspreferenser)
• Betalningsinformation
• Och mycket mer (se komplett dataspecifikation)

Kommande funktioner

Vi utökar aktivt API:et med:

• Spelardataändpunkter (med samma auktorisering)
• Förbättrad tillgång till betalningshistorik
• Detaljerad information om evenemang, aktiviteter och kliniker

Kontakta din kontochef för att begära specifika funktioner eller uttrycka intresse för kommande funktioner.

Komma igång

1. Begär åtkomst

1. Kontakta din Playtomic-kontochef eller kundtjänst via chatten för att begära API-åtkomst
2. Motta dina inloggningsuppgifter via en säker länk (giltig i 3 dagar, maximalt 3 öppningar)
3. Lagra inloggningsuppgifter säkert - den tillfälliga länken kommer att upphöra
4. Få tillgång till dokumentation och börja integrera

📄 Komplett API-dokumentation (v1.1)

⚠️ Viktigt: Spara dina inloggningsuppgifter omedelbart eftersom åtkomstlänken snabbt upphör och inte kan återskapas enkelt.

2. Förstå autentisering

API:et använder OAuth 2.0 för säker åtkomst:

Dina inloggningsuppgifter:

• Klient-ID & Klienthemlighet: Unika identifierare för din klubb/system
• Åtkomsttoken: Tillfällig inloggningsuppgift (vanligtvis giltig i 1 timme) för API-anrop

Exempel på tokenbegäran:

POST <https://api.playtomic.io/oauth/token>
Content-Type: application/json

{
  "client_id": "your_client_id",
  "client_secret": "your_client_secret",
  "grant_type": "client_credentials"
}

Göra API-anrop:

GET <https://api.playtomic.io/v1/bookings>
Authorization: Bearer your_access_token

🔒 Säkerhetsbästa praxis:

• Håll din klienthemlighet konfidentiell
• Exponera aldrig inloggningsuppgifter i offentliga arkiv
• Implementera automatisk tokenförnyelse i dina system

Dataspecifikationer & Begränsningar

Hantering av tidszoner

• Alla tidsstämplar är i UTC - se till att dina system konverterar till lokal tidszon
• Verifiera din klubbs tidszonsinställningar i Playtomic Manager > Inställningar > Klubbinfo

Data tillgänglighet

• Historiska data: De senaste 90 dagarna
• Framtida bokningar: Tillgängliga enligt schema
• Maximalt begärningsintervall: 365 dagar (90 tidigare + 275 framtida, eller 365 framtida)

Hastighetsbegränsningar

API-anrop är föremål för hastighetsbegränsning (vanligtvis 1 anrop per minut) för att säkerställa systemstabilitet. Kontrollera dokumentationen för aktuella begränsningar.

Vanliga användningsfall

Transformera din klubbverksamhet med dessa populära integrationer:

• CRM-synkronisering: Importera bokningsdata för riktade marknadsföringskampanjer
• Analys & Rapportering: Analysera banutnyttjande och spelarfrekvensmönster
• Medlemskommunikation: Skicka automatiska bekräftelser och påminnelser via externa verktyg
• Anläggningshantering: Integrera med smarta dörrlås, belysning eller andra IoT-system
• Lojalitetsprogram: Spåra medlemsaktivitet för belönings- och lojalitetsprogram

Felsökning & Support

Få hjälp

• Kontohanterare: Bedömning av genomförbarhet och åtkomstförfrågningar
• Teknisk support: Felsökning av API och integrationshjälp
• Dokumentation: Kompletta exempel, parametrar och beskrivningar av slutpunkter

Testa din integration

Även om vi inte tillhandahåller en separat testmiljö kan du säkert testa med dina faktiska bokningsdata med begränsade förfrågningar under utvecklingen.

Vanliga frågor (FAQ)

Autentisering & Åtkomst

F: Hur får jag API-referenser?

S: Kontakta din Playtomic-kontohanterare eller supportteam. När det har godkänts får du en säker länk (giltig i 3 dagar, max 3 öppningar) som innehåller ditt Client ID och Client Secret.

F: Vad ska jag göra om jag får "Obehörig" fel (401/403)?

S: Vanliga lösningar:

• Verifiera att din Authorization: Bearer token header är inkluderad
• Kontrollera om din åtkomsttoken har gått ut (uppdatera vid behov)
• Bekräfta att ditt Client ID och Client Secret är korrekta

• Säkerställ att du inte har överskridit gränserna för förfrågningar

   

F: Kan någon annan i min organisation begära nya referenser?

S: Ja, men viktigt: Nya referensförfrågningar kommer att återkalla de gamla. Dela referenser inom din organisation för att undvika att störa befintliga integrationer.

Dataåtkomst & Funktioner

F: Kan jag skapa eller ändra bokningar via API:et?

S: Nej, det nuvarande API:et är endast läsning. Du kan hämta och analysera bokningsdata men kan inte skapa, uppdatera eller ta bort bokningar.

F: Hur mycket historisk data kan jag komma åt?

S: Du kan komma åt bokningsdata från de senaste 90 dagarna plus alla framtida bokningar. Maximal förfrågningsintervall är totalt 365 dagar.

F: Vilken tidszon är API-tidsstämplarna i?

S: Alla tidsstämplar är i UTC. Din integration måste konvertera dessa till din lokala tidszon. Kontrollera att din klubbs tidszon är korrekt inställd i Playtomic Manager.

Flera platser & Kedjehantering

F: Som kedjeägare, får jag tillgång till alla mina klubbars data?

S: Ja! Kedjeägare får enhetlig tillgång till bokningsdata över alla klubbar i deras organisation. Du kan filtrera förfrågningar för specifika klubbar eller hämta data för alla platser.

F: Behöver alla platser Champion/Master-abonnemang?

S: Ja, för åtkomst till flera platser måste varje hyresgäst ha en Champion- eller Master-abonnemangsplan.

Teknisk implementering

F: Hur ofta kan jag anropa API:et?

S: Gränser för förfrågningar finns (vanligtvis 1 anrop per minut) för att säkerställa systemstabilitet. Kontrollera dokumentationen för aktuella gränser och planera din integration därefter.

F: Kan jag testa API:et innan det går live?

S: Även om det inte finns någon separat testmiljö kan du säkert testa med dina faktiska bokningsdata med begränsade förfrågningar under utvecklingen.

F: Kommer fler funktioner att läggas till i API:et?

S: Ja! Vi utvecklar aktivt:

• Spelardata-slutpunkter (samma autentisering)
• Förbättrad betalningshistorik
• Detaljerad data om evenemang och kliniker

Kontakta din kontohanterare för att begära specifika funktioner.

Support & Felsökning

F: Vilken information ska jag ge när jag begär support?

S: Inkludera:

• Fullständigt felmeddelande
• Specifik slutpunkt du anropade
• Ditt klubb-ID

• Steg du redan har provat

   

F: Vem ska jag kontakta för olika typer av problem?

S:

• Åtkomstförfrågningar: Kontohanterare eller kundtjänst via chat för att begära API-åtkomst
• Teknisk integration: Teknisk supportteam
• Funktionsförfrågningar: Kontohanterare
• Fakturering/abonnemang: Kontohanterare

Behöver du ytterligare hjälp? Kontakta din Playtomic-kontohanterare eller vårt kundtjänstteam för personlig hjälp med din API-integration.