PADEL LABDevelopers
v1.0.0-beta.1OpenAPIIm Club verwalten
GuidesAPI ReferenceSDKsOpenAPI JSONIm Club verwalten
CLUB APIv1.0.0-beta.1Private Beta

Baue den Club
in dein System.

Eine mandantengebundene Server-zu-Server-API für Buchungen, Courts, Matches, Scores und Events – mit expliziter Datenhoheit und einem Principal pro Club-Installation.

Schnellstart API Reference OpenAPI 3.1
Tenant-bound Private-Key-JWT Replay-first realtime
REQUEST TRACEreq_01JABCACCEPTED · 202
PUT/booking-sources/src_…/bookings/booking-1001
  1. 1InstallClub Owner autorisiert App und Scopes
  2. 2TokenBackend signiert Private-Key-JWT
  3. 3ContextAPI bindet Token an genau einen Club
  4. 4SyncSnapshots tragen steigende source_version
  5. 5DeliverReplay, WebSocket oder Webhook
BOOKING SNAPSHOTsource_version 42
MATCH STATEprotected
OUTCOMEreconciliation required
26Operationen
11explizite Scopes
7 TageEvent Replay
1 Clubpro Installation

Production https://api.padel-lab.crewio.co/v1/club

Der kürzeste sichere Weg

Vom Owner-Consent
zum ersten Context.

Die Integration beginnt nicht mit einer frei gewählten Club-ID. Sie beginnt mit einer Installation, deren Tokenbindung den Mandanten festlegt.

01

Install

Club Owner autorisiert App und Scopes

02

Token

Backend signiert Private-Key-JWT

03

Context

API bindet Token an genau einen Club

04

Sync

Snapshots tragen steigende source_version

First requestbash
curl 'https://sandbox-api.padel-lab.crewio.co/v1/club/context' \
  --header "Authorization: Bearer $PADEL_LAB_TOKEN"
Schnellstart vollständig lesen
Surface map

Vier Wege durch
denselben Vertrag.

Beginne beim Datenfluss, nicht bei einer alphabetischen Liste. Jede Route führt von einem fachlichen Ziel zur exakten Operation.

Club SurfaceContext, Standorte und Courtsclub:read · locations:read · courts:readBooking InboundQuellen, Mappings, Imports und Snapshotsbookings:read · bookings:writeMatch Read ModelSessions, Teilnehmer und ScoreEventssessions:read · participants:read · scores:readRealtimeReplay, Stream-Tickets und Webhooksevents:read · webhooks:manage
Datenhoheit

Synchronisieren,
ohne Matchzustand
zu überschreiben.

Das externe Buchungssystem besitzt Termin, Court-Reservierung und Buchungsstatus. Padel Lab besitzt MatchSession, bestätigte Teilnehmer, Matchzustand und Scoring.

Buchungsmodell verstehen
EXTERNAL SOURCEPADEL LAB
TerminMatchSession
Court-Reservierungbestätigte Teilnehmer
BuchungsstatusMatchzustand
source_versionScoreEvents
Späte Änderungen erzeugen einen sichtbaren Abgleichkonflikt.
PUBLICATION SEQUENCE
9007199254740990booking.updated
9007199254740991session.status_changed
9007199254740992match.started
9007199254740993score.updated
9007199254740994match.completed
Replay before reconnect

Realtime, das
Lücken erwartet.

Events werden mindestens einmal zugestellt. Consumer deduplizieren anhand der Event-ID, speichern ihren Cursor dauerhaft und replayen vor jedem neuen WebSocket.

WebSocket & Replay Webhooks absichern
Vertrag statt Vermutung

Alle 26 Operationen.
Direkt aus OpenAPI.

Parameter, Scopes, Request-Schema und jeder dokumentierte Status werden beim Build aus dem versionierten Vertrag gelesen.

Reference öffnen