SDKs und Vertragswerkzeuge

Versionierte TypeScript- und Python-Clients, HTTP-Collection und transparente Referenzintegrationen.

7 Min. Lesezeit

OpenAPI ist die Quelle

OpenAPI 3.1 definiert alle 26 Operationen, DTOs, Scopes und Statuscodes. Diese Website liest die Referenz beim Build direkt aus demselben Vertrag.

Downloadbash

curl --output club-api-v1.json \
  https://developers.padel-lab.crewio.co/openapi.json

TypeScript SDK

Der generierte ESM-Client enthält typisierte Requestobjekte und alle 26 Operationen. Er ist im Repository versioniert; eine Veröffentlichung auf npm wird nicht vorausgesetzt.

Usagetypescript

import {ClubApiClient} from "@padel-lab/club-api-sdk";

const api = new ClubApiClient({
  baseUrl: "https://sandbox-api.padel-lab.crewio.co/v1/club",
  accessToken: () => tokenProvider.token(),
});

const context = await api.getContext();

Python SDK

Der Python-Client erfordert Python 3.11 oder neuer und modelliert Requests und Antworten mit typisierten Dictionaries. Auch er folgt dem versionierten Vertrag im Repository.

Usagepython

from padel_lab_club_api import ClubApiClient

api = ClubApiClient(
    "https://sandbox-api.padel-lab.crewio.co/v1/club",
    access_token=obtain_short_lived_m2m_token,
)

context = api.get_context()

Referenzclients

PKCE-, state- und nonce-sichere Partnerinstallation
RS256 Private-Key-JWT und Token-Caching
Pagination und vollständige Buchungssnapshots
Consent-Minimierung
Event-Replay vor jedem WebSocket-Reconnect
Raw-Body-HMAC-Verifikation für Webhooks

Vorwärtskompatibel bleiben

V1 darf additive Felder erhalten. SDK- und Eigenbau-Clients müssen unbekannte Felder sowie unbekannte Enum-Werte tolerieren und dürfen nicht auf Textmeldungen verzweigen.