Die Playtomic Club API ermöglicht es Clubbesitzern, ihre Buchungsdaten nahtlos mit externen Systemen zu integrieren, um Abläufe zu optimieren und das Mitgliedererlebnis zu verbessern. Dieser umfassende Leitfaden behandelt alles, was du über den Zugriff und die Nutzung unserer API wissen musst.

Was ist die Playtomic Club API?

Die Playtomic Club API ist eine sichere, schreibgeschützte Schnittstelle, die es Clubs ermöglicht, auf ihre Buchungsdaten programmgesteuert zuzugreifen. Egal, ob du einen einzelnen Standort betreibst oder mehrere Einrichtungen verwaltest, die API ermöglicht es dir:

• Integration mit bestehenden Systemen wie CRMs, Marketing-Tools, Treueplattformen oder Facility-Management-Software
• Zugriff auf Echtzeit- und historische Buchungsdaten der letzten 3 Monate
• Automatisierung der Datensynchronisation zur Optimierung der Clubabläufe

• Verbesserung der Mitgliederkommunikation durch externe Tools und Plattformen

   

  📋 Hinweis für Syltek Clubs: Du kannst die API mit derselben Datensichtbarkeit wie im Manager nutzen. Während Buchungen von Syltek synchronisiert werden, beachte bitte, dass nicht alle Planungselemente (wie Kurse) synchronisiert werden können.

Wer kann auf die API zugreifen?

API-Zugriff ist verfügbar für:

• Einzelstandort-Clubs mit Champion- oder Master-Abonnementplänen
• Mehrstandort-Clubs, bei denen jeder Mieter ein Champion- oder Master-Abonnement hat
• Kettenbesitzer, die einen einheitlichen Zugriff auf alle Clubdaten innerhalb ihrer Organisation erhalten

Aktuelle API-Funktionen

Unsere schreibgeschützte API bietet Zugriff auf umfassende Buchungsdaten, einschließlich:

• Buchungs-ID und Zeitstempel (UTC-Format)
• Platzinformationen (ID, Name)
• Spielerdetails (IDs, E-Mail, Kommunikationspräferenzen)
• Zahlungsinformationen
• Und vieles mehr (vollständige Datenspezifikation anzeigen)

Kommende Funktionen

Wir erweitern die API aktiv mit:

• Spielerdaten-Endpunkten (mit derselben Autorisierung)
• Erweitertem Zugriff auf die Zahlungshistorie
• Detaillierten Daten zu Veranstaltungen, Aktivitäten und Kliniken

Kontaktiere deinen Account Manager, um spezifische Funktionen anzufordern oder Interesse an kommenden Möglichkeiten zu bekunden.

Erste Schritte

1. Zugriff anfordern

1. Kontaktiere deinen Playtomic Account Manager oder den Kundenservice über den Chat, um API-Zugriff anzufordern
2. Erhalte deine Zugangsdaten über einen sicheren Link (gültig für 3 Tage, maximal 3 Öffnungen)
3. Speichere die Zugangsdaten sicher - der temporäre Link wird ablaufen
4. Zugriff auf Dokumentation und Integration beginnen

📄 Vollständige API-Dokumentation (v1.1)

⚠️ Wichtig: Speichere deine Zugangsdaten sofort, da der Zugangslink schnell abläuft und nicht leicht neu generiert werden kann.

2. Authentifizierung verstehen

Die API verwendet OAuth 2.0 für sicheren Zugriff:

Deine Zugangsdaten:

• Client ID & Client Secret: Einzigartige Kennungen für deinen Club/dein System
• Access Token: Temporäre Berechtigung (typischerweise gültig für 1 Stunde) für API-Aufrufe

Beispiel für Token-Anforderung:

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-Aufrufe durchführen:

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

🔒 Sicherheitsbest Practices:

• Halte dein Client Secret vertraulich
• Gib niemals Zugangsdaten in öffentlichen Repositories preis
• Implementiere die automatische Token-Erneuerung in deinen Systemen

Daten-Spezifikationen & Einschränkungen

Zeitzonen-Handhabung

• Alle Zeitstempel sind in UTC - stelle sicher, dass deine Systeme in die lokale Zeitzone umwandeln
• Überprüfe die Zeitzoneneinstellungen deines Clubs in Playtomic Manager > Einstellungen > Clubinfo

Datenverfügbarkeit

• Historische Daten: Vergangene 90 Tage
• Zukünftige Buchungen: Verfügbar wie geplant
• Maximaler Anforderungsbereich: 365 Tage (90 vergangene + 275 zukünftige, oder 365 zukünftige)

Ratenlimits

API-Aufrufe unterliegen Ratenlimits (typischerweise 1 Aufruf pro Minute), um die Systemstabilität zu gewährleisten. Überprüfe die Dokumentation für aktuelle Limits.

Häufige Anwendungsfälle

Transformiere deine Clubabläufe mit diesen beliebten Integrationen:

• CRM-Synchronisation: Importiere Buchungsdaten für gezielte Marketingkampagnen
• Analyse & Berichterstattung: Analysiere die Platzauslastung und Spielerfrequenzmuster
• Mitgliederkommunikation: Sende automatisierte Bestätigungen und Erinnerungen über externe Tools
• Facility Management: Integration mit intelligenten Türschlössern, Beleuchtung oder anderen IoT-Systemen
• Treueprogramme: Verfolge die Mitgliederaktivität für Belohnungs- und Bindungsprogramme

Fehlerbehebung & Support

Hilfe erhalten

• Account Manager: Machbarkeitsbewertung und Zugriffsanfragen
• Technischer Support: API-Fehlerbehebung und Integrationsunterstützung
• Dokumentation: Vollständige Beispiele, Parameter und Endpunktbeschreibungen

Testen Ihrer Integration

Obwohl wir keine separate Testumgebung bereitstellen, können Sie sicher mit Ihren tatsächlichen Buchungsdaten testen, indem Sie während der Entwicklung eingeschränkte Abfragen verwenden.

Häufig gestellte Fragen (FAQ)

Authentifizierung & Zugriff

F: Wie erhalte ich API-Zugangsdaten?

A: Kontaktieren Sie Ihren Playtomic-Account-Manager oder das Support-Team. Nach Genehmigung erhalten Sie einen sicheren Link (gültig 3 Tage, maximal 3 Öffnungen), der Ihre Client-ID und Ihr Client-Secret enthält.

F: Was soll ich tun, wenn ich "Unauthorized"-Fehler (401/403) erhalte?

A: Häufige Lösungen:

• Überprüfen Sie, ob Ihr Authorization: Bearer token-Header enthalten ist
• Prüfen Sie, ob Ihr Zugriffstoken abgelaufen ist (bei Bedarf aktualisieren)
• Bestätigen Sie, dass Ihre Client-ID und Ihr Client-Secret korrekt sind

• Stellen Sie sicher, dass Sie die Ratenlimits nicht überschritten haben

   

F: Kann jemand anderes in meiner Organisation neue Zugangsdaten anfordern?

A: Ja, aber wichtig: Neue Anfragen für Zugangsdaten widerrufen die alten. Teilen Sie Zugangsdaten innerhalb Ihrer Organisation, um bestehende Integrationen nicht zu stören.

Datenzugriff & Fähigkeiten

F: Kann ich Buchungen über die API erstellen oder ändern?

A: Nein, die aktuelle API ist nur lesbar. Sie können Buchungsdaten abrufen und analysieren, aber keine Buchungen erstellen, aktualisieren oder löschen.

F: Wie viele historische Daten kann ich abrufen?

A: Sie können Buchungsdaten der letzten 90 Tage sowie alle zukünftigen Buchungen abrufen. Der maximale Anforderungsbereich beträgt insgesamt 365 Tage.

F: In welcher Zeitzone sind die API-Zeitstempel?

A: Alle Zeitstempel sind in UTC. Ihre Integration muss diese in Ihre lokale Zeitzone umwandeln. Überprüfen Sie, ob die Zeitzone Ihres Clubs im Playtomic Manager korrekt eingestellt ist.

Multi-Standort & Kettenmanagement

F: Erhalte ich als Ketteninhaber Zugriff auf die Daten all meiner Clubs?

A: Ja! Ketteninhaber erhalten einen einheitlichen Zugriff auf Buchungsdaten aller Clubs in ihrer Organisation. Sie können Anfragen für bestimmte Clubs filtern oder Daten für alle Standorte abrufen.

F: Benötigen alle Standorte Champion/Master-Abonnements?

A: Ja, für den Zugriff auf mehrere Standorte muss jeder Mieter einen Champion- oder Master-Abonnementplan haben.

Technische Implementierung

F: Wie oft kann ich die API aufrufen?

A: Es gibt Ratenlimits (typischerweise 1 Aufruf pro Minute), um die Systemstabilität zu gewährleisten. Überprüfen Sie die Dokumentation für aktuelle Limits und planen Sie Ihre Integration entsprechend.

F: Kann ich die API testen, bevor sie live geht?

A: Obwohl es keine separate Testumgebung gibt, können Sie sicher mit Ihren tatsächlichen Buchungsdaten testen, indem Sie während der Entwicklung eingeschränkte Abfragen verwenden.

F: Werden der API weitere Funktionen hinzugefügt?

A: Ja! Wir entwickeln aktiv:

• Spielerdaten-Endpunkte (gleiche Autorisierung)
• Erweiterte Zahlungshistorie
• Detaillierte Veranstaltungs- und Klinikdaten

Kontaktieren Sie Ihren Account Manager, um spezifische Funktionen anzufordern.

Support & Fehlerbehebung

F: Welche Informationen sollte ich bereitstellen, wenn ich Support anfordere?

A: Geben Sie Folgendes an:

• Vollständige Fehlermeldung
• Spezifischer Endpunkt, den Sie aufgerufen haben
• Ihre Club-ID

• Bereits unternommene Schritte

   

F: Wen sollte ich bei verschiedenen Arten von Problemen kontaktieren?

A:

• Zugriffsanfragen: Account Manager oder Kundenbetreuung über Chat, um API-Zugriff anzufordern
• Technische Integration: Technisches Support-Team
• Funktionsanfragen: Account Manager
• Abrechnung/Abonnement: Account Manager

Benötigen Sie zusätzliche Unterstützung? Kontaktieren Sie Ihren Playtomic-Account-Manager oder unser Kundenbetreuungsteam für persönliche Hilfe bei Ihrer API-Integration.