De Playtomic Club API stelt club-eigenaren in staat om hun boekingsgegevens naadloos te integreren met externe systemen, waardoor de operaties worden gestroomlijnd en de ledenervaring wordt verbeterd. Deze uitgebreide gids behandelt alles wat je moet weten over het openen en gebruiken van onze API.

Wat is de Playtomic Club API?

De Playtomic Club API is een veilige, alleen-lezen interface die clubs in staat stelt om hun boekingsgegevens programmeerbaar te benaderen. Of je nu een enkele locatie beheert of meerdere faciliteiten, de API stelt je in staat om:

• Te integreren met bestaande systemen zoals CRM's, marketingtools, loyaliteitsplatforms of faciliteitsbeheersoftware
• Toegang te krijgen tot real-time en historische boekingsgegevens van de afgelopen 3 maanden
• Gegevenssynchronisatie te automatiseren om cluboperaties te stroomlijnen

• De communicatie met leden te verbeteren via externe tools en platforms

   

  📋 Opmerking voor Syltek Clubs: Je kunt de API gebruiken met dezelfde gegevenszichtbaarheid als in Manager. Hoewel boekingen worden gesynchroniseerd vanuit Syltek, houd er rekening mee dat niet alle schema-elementen (zoals lessen) gesynchroniseerd kunnen worden.

Wie kan toegang krijgen tot de API?

API-toegang is beschikbaar voor:

• Clubs met één locatie met Champion- of Master-abonnementen
• Clubs met meerdere locaties waar elke huurder een Champion- of Master-abonnement heeft
• Keten eigenaren die verenigde toegang krijgen tot alle clubgegevens binnen hun organisatie

Huidige API-functies

Onze alleen-lezen API biedt toegang tot uitgebreide boekingsgegevens, waaronder:

• Boekings-ID en tijdstempels (UTC-formaat)
• Baaninformatie (ID, naam)
• Spelersgegevens (ID's, e-mail, communicatievoorkeuren)
• Betalingsinformatie
• En nog veel meer (bekijk de volledige gegevensspecificatie)

Toekomstige functies

We breiden de API actief uit met:

• Spelersgegevens eindpunten (met dezelfde autorisatie)
• Verbeterde toegang tot betalingsgeschiedenis
• Gedetailleerde gegevens over evenementen, activiteiten en clinics

Neem contact op met je accountmanager om specifieke functies aan te vragen of interesse te tonen in toekomstige mogelijkheden.

Aan de slag

1. Toegang aanvragen

1. Neem contact op met je Playtomic accountmanager of Customer Care via chat om API-toegang aan te vragen
2. Ontvang je inloggegevens via een beveiligde link (geldig voor 3 dagen, maximaal 3 keer openen)
3. Sla inloggegevens veilig op - de tijdelijke link zal verlopen
4. Toegang tot documentatie en begin met integratie

📄 Volledige API-documentatie (v1.1)

⚠️ Belangrijk: Sla je inloggegevens onmiddellijk op, aangezien de toegangslink snel verloopt en niet gemakkelijk opnieuw kan worden gegenereerd.

2. Begrip van authenticatie

De API maakt gebruik van OAuth 2.0 voor veilige toegang:

Jouw inloggegevens:

• Client ID & Client Secret: Unieke identificatoren voor je club/systeem
• Access Token: Tijdelijke inloggegevens (meestal geldig voor 1 uur) voor API-aanroepen

Voorbeeld van tokenaanvraag:

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

API-aanroepen doen:

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

🔒 Beveiligingspraktijken:

• Houd je Client Secret vertrouwelijk
• Stel nooit inloggegevens bloot in openbare repositories
• Implementeer automatische tokenvernieuwing in je systemen

Gegevensspecificaties & Beperkingen

Tijdzoneverwerking

• Alle tijdstempels zijn in UTC - zorg ervoor dat je systemen omzetten naar lokale tijdzone
• Controleer de tijdzone-instellingen van je club in Playtomic Manager > Instellingen > Clubinfo

Gegevensbeschikbaarheid

• Historische gegevens: Afgelopen 90 dagen
• Toekomstige boekingen: Beschikbaar zoals gepland
• Maximale aanvraagbereik: 365 dagen (90 verleden + 275 toekomst, of 365 toekomst)

Snelheidslimieten

API-aanroepen zijn onderhevig aan snelheidslimieten (meestal 1 oproep per minuut) om systeemstabiliteit te waarborgen. Controleer de documentatie voor de huidige limieten.

Veelvoorkomende gebruikssituaties

Transformeer je cluboperaties met deze populaire integraties:

• CRM-synchronisatie: Importeer boekingsgegevens voor gerichte marketingcampagnes
• Analyse & Rapportage: Analyseer baangebruik en spelersfrequentiepatronen
• Ledencommunicatie: Stuur geautomatiseerde bevestigingen en herinneringen via externe tools
• Faciliteitsbeheer: Integreer met slimme deursloten, verlichting of andere IoT-systemen
• Loyaliteitsprogramma's: Volg ledenactiviteit voor belonings- en retentieprogramma's

Probleemoplossing & Ondersteuning

Hulp krijgen

• Accountmanager: Beoordeling van haalbaarheid en toegangsverzoeken
• Technische ondersteuning: Problemen met de API oplossen en hulp bij integratie
• Documentatie: Volledige voorbeelden, parameters en beschrijvingen van eindpunten

Je integratie testen

Hoewel we geen aparte testomgeving bieden, kun je veilig testen met je daadwerkelijke boekingsgegevens door beperkte queries te gebruiken tijdens de ontwikkeling.

Veelgestelde vragen (FAQ)

Authenticatie & Toegang

V: Hoe krijg ik API-referenties?

A: Neem contact op met je Playtomic accountmanager of ondersteuningsteam. Zodra goedgekeurd, ontvang je een beveiligde link (3 dagen geldig, maximaal 3 keer openen) met je Client ID en Client Secret.

V: Wat moet ik doen als ik "Unauthorized" fouten (401/403) krijg?

A: Veelvoorkomende oplossingen:

• Controleer of je Authorization: Bearer token header is inbegrepen
• Controleer of je toegangstoken is verlopen (ververs indien nodig)
• Bevestig dat je Client ID en Client Secret correct zijn

• Zorg ervoor dat je de snelheidslimieten niet hebt overschreden

   

V: Kan iemand anders in mijn organisatie nieuwe referenties aanvragen?

A: Ja, maar belangrijk: Nieuwe referentieaanvragen zullen de oude intrekken. Deel referenties binnen je organisatie om verstoring van bestaande integraties te voorkomen.

Gegevens Toegang & Mogelijkheden

V: Kan ik boekingen maken of wijzigen via de API?

A: Nee, de huidige API is alleen-lezen. Je kunt boekingsgegevens ophalen en analyseren, maar je kunt geen boekingen maken, bijwerken of verwijderen.

V: Hoeveel historische gegevens kan ik benaderen?

A: Je kunt boekingsgegevens van de afgelopen 90 dagen plus alle toekomstige boekingen benaderen. De maximale aanvraagperiode is in totaal 365 dagen.

V: In welke tijdzone staan de API-tijdstempels?

A: Alle tijdstempels zijn in UTC. Je integratie moet deze omzetten naar je lokale tijdzone. Controleer of de tijdzone van je club correct is ingesteld in Playtomic Manager.

Multi-Locatie & Kettingbeheer

V: Als keteneigenaar, krijg ik toegang tot de gegevens van al mijn clubs?

A: Ja! Keteneigenaren krijgen uniforme toegang tot boekingsgegevens van alle clubs in hun organisatie. Je kunt verzoeken filteren voor specifieke clubs of gegevens ophalen voor alle locaties.

V: Hebben alle locaties Champion/Master abonnementen nodig?

A: Ja, voor toegang tot meerdere locaties moet elke huurder een Champion of Master abonnement hebben.

Technische Implementatie

V: Hoe vaak kan ik de API aanroepen?

A: Er zijn snelheidslimieten ingesteld (meestal 1 oproep per minuut) om de stabiliteit van het systeem te waarborgen. Controleer de documentatie voor de huidige limieten en plan je integratie dienovereenkomstig.

V: Kan ik de API testen voordat ik live ga?

A: Hoewel er geen aparte testomgeving is, kun je veilig testen met je daadwerkelijke boekingsgegevens door beperkte queries te gebruiken tijdens de ontwikkeling.

V: Zullen er meer functies aan de API worden toegevoegd?

A: Ja! We zijn actief bezig met de ontwikkeling van:

• Spelergegevens eindpunten (zelfde autorisatie)
• Verbeterde betalingsgeschiedenis
• Gedetailleerde evenement- en clinicgegevens

Neem contact op met je accountmanager om specifieke functies aan te vragen.

Ondersteuning & Probleemoplossing

V: Welke informatie moet ik verstrekken bij het aanvragen van ondersteuning?

A: Voeg toe:

• Volledig foutbericht
• Specifiek eindpunt dat je aanriep
• Je Club ID

• Stappen die je al hebt geprobeerd

   

V: Wie moet ik contacteren voor verschillende soorten problemen?

A:

• Toegangsverzoeken: Accountmanager of Klantenservice via chat om API-toegang aan te vragen
• Technische integratie: Technisch ondersteuningsteam
• Functieaanvragen: Accountmanager
• Facturering/abonnement: Accountmanager

Heb je extra hulp nodig? Neem contact op met je Playtomic accountmanager of ons Klantenserviceteam voor persoonlijke hulp bij je API-integratie.