Überblick
Die freigegebenen /v1-Partner-Endpunkte, gerendert aus der OpenAPI-Spezifikation.
Diese Referenz wird direkt aus der Partner-OpenAPI-Spezifikation erzeugt (OpenAPI 3.1). Jede Seite zeigt Parameter, Request- und Response-Schemas, Fehlercodes und ein „Try it out" gegen die Sandbox.
Abhaengigkeit: Die hier gezeigten Endpunkte stammen aus der vertragskonformen
Platzhalter-Spec (spec/partner-v1.openapi.json). Sobald ISSUE-0104 (OpenAPI aus
Zod) die generierte Partner-Spec als Release-Asset liefert, wird diese Datei
ausgetauscht — die Darstellung bleibt unveraendert. Stand der Generierung
(2026-10-16): 0 Routen fuer Partner freigegeben, daher repraesentative Beispiele.
Konventionen
- Basis-URL je Umgebung aus der
servers-Liste. Im Portal steht nur die Sandbox, nie die Produktion. - Authentifizierung per
Authorization: Bearer pc_live_…/pc_test_…oder OAuth2client_credentials— siehe Authentifizierung. - Scopes stehen je Operation (z. B.
read:events); Hierarchie in Scopes & Ebenen. - Fehler als Problem Details (RFC 7807) — siehe Fehlerformat.
Endpunkte
Ausliefern und versionieren
Template zur Build-Zeit ins Image bringen, Semver und Veröffentlichung.
Termine auflisten
Liefert oeffentliche Termine. Anonyme Aufrufe (`view`) erhalten nur oeffentliche Felder; authentifizierte Aufrufe mit `read:events` zusaetzlich geschuetzte Felder (Field-Projection, server-autoritativ).