Booking API nutzen

Mit der Booking API kannst du Platzbuchungen aus deinem Verein in externe Systeme exportieren — zum Beispiel in ein Reporting, ein Vereinsportal oder eine eigene Integration.

API-Schlüssel erzeugen

Öffne als Admin die Vereinsverwaltung und wähle Monitor & Terminal. Scrolle zum Bereich Booking API.

• Mit Schlüssel erzeugen legst du den ersten API-Schlüssel an.
• Mit Schlüssel erneuern erzeugst du einen neuen Schlüssel und machst den bisherigen sofort ungültig.
• Mit Kopieren legst du den aktuellen Schlüssel in die Zwischenablage.

Es gibt immer genau einen aktiven Booking-API-Schlüssel pro Verein.

Basis-URL und OpenAPI

• Basis-URL: https://api.tennify.de/v1
• Swagger UI: https://api.tennify.de/v1/docs
• OpenAPI: https://api.tennify.de/v1/openapi.json

Die OpenAPI-Datei beschreibt die verfügbaren Parameter und das Antwortformat. Mit der Swagger-Oberfläche kannst du die API direkt im Browser inspizieren und testen.

Authentifizierung

Jede Anfrage an den Buchungsendpunkt benötigt den Header:

x-api-key: DEIN_API_SCHLUESSEL

Der Schlüssel ist auf deinen Verein begrenzt. Du musst also kein clubId mitsenden.

Buchungen abrufen

Verfügbarer Endpunkt:

GET /bookings?start=<ISO-8601>&end=<ISO-8601>

Beispiel:

curl \
  -H "x-api-key: DEIN_API_SCHLUESSEL" \
  "https://api.tennify.de/v1/bookings?start=2026-04-01T00:00:00.000Z&end=2026-04-30T23:59:59.000Z"

Was zurückgegeben wird

Jede Buchung enthält:

• Platzname und Platz-ID
• Start- und Endzeit
• Buchungstyp
• Anonym-Flag
• Beschreibung
• registrierte Spieler mit id, lastName, firstName
• guestNames für Gäste ohne tennify-Konto

Die API liefert Buchungen, die den angefragten Zeitraum überlappen. Eine Buchung wird also auch dann zurückgegeben, wenn sie vor dem Startzeitpunkt begonnen hat, aber noch in den Zeitraum hineinragt.

Limits

• maximal 2 Anfragen pro Minute pro API-Schlüssel
• maximal ein Jahr pro Anfrage

Wenn du den Schlüssel erneuerst, funktionieren bestehende Integrationen erst wieder nach dem Austausch des Schlüssels.