Request-Beispiele

Kopierbare, synthetische Beispiele mit Platzhaltern, Request-ID und klarer Fehlerbehandlung.

Platzhalter ersetzen

ACCESS_TOKEN, ORGANIZATION_ID und PROJECT_ID werden zur Laufzeit aus dem eigenen autorisierten Kontext eingesetzt. Beispiele enthalten keine echten Tokens oder Kundendaten.

Antwort prüfen

Clients prüfen HTTP-Status, Content-Type und den ApiErrorResponse-Vertrag. Ein 2xx-Status wird nicht allein aus einem JSON-Feld abgeleitet.

Aktuellen Principal lesen

curl --fail-with-body \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  -H 'x-request-id: docs-example-0001' \
  'https://api.example.invalid/me'

Sichtbare Projekte lesen

curl --fail-with-body \
  -H 'Authorization: Bearer <ACCESS_TOKEN>' \
  'https://api.example.invalid/projects?organizationId=<ORGANIZATION_ID>'