YYYY-MM-DD). Das veröffentlichte OpenAPI-Dokument enthält seine Vertragsversion als
info["x-contract-version"], und jede Operation deklariert ihre Lebenszyklusphase
als x-lifecycle-stage (preview, compatibility oder ga).
- Die aktuelle Spezifikation ist stets unter
/v1-reference/openapi-v1.jsonverfügbar. - Versionierte Referenz-Snapshots sind unter
/v1-reference/openapi/<version>.jsonverfügbar, zum Beispiel/v1-reference/openapi/2026-07-01.json.
Dokumentationsaktualisierungen
2026-08-25 — Die/v1-Leitfäden und die OpenAPI-servers-Liste nennen nun die aktiven
regionalen Hosts für die USA und die EU. Dies ist eine Klarstellung in der Dokumentation. Die Vertragsversion
bleibt unverändert. Siehe Regionen.
2026-07-01
Die/v1 Public API unterstützt diese Vertragsversion. Legen Sie sie mit
Living-Security-Version: 2026-07-01 fest, oder verwenden Sie die Standardversion, die Ihrem Servicekonto
zugewiesen ist.
Siehe die API-Schnellstartanleitung für Ihre erste Anfrage,
Authentifizierung für API-Schlüssel und OAuth sowie
Regionen für den richtigen Host.
2026-08-05
Dieses Datum kennzeichnet den separaten älteren/api/v1-Kompatibilitätsvertrag.
Es ist kein Living-Security-Version-Wert für die neue /v1-API.
- Leute: Leute der Organisation durchsuchen (
GET /people/search) und die Mitgliedschaft einer Person abrufen (GET /people/{personId}/membership). - API-Zugriffsschlüssel: API-Zugriffsschlüssel erstellen, auflisten, rotieren und widerrufen
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility veröffentlicht.
Siehe die Übersicht zur Public API für
Authentifizierung, Paginierung und Fehlerbehandlung sowie die
Richtlinie zu Kompatibilität und Einstellung
dazu, wie sich dieser Vertrag weiterentwickelt.
