YYYY-MM-DD). Het gepubliceerde OpenAPI-document bevat de contractversie als
info["x-contract-version"], en elke operatie geeft de levenscyclusfase aan
als x-lifecycle-stage (preview, compatibility of ga).
- De actuele specificatie is altijd beschikbaar op
/v1-reference/openapi-v1.json. - Versiegebonden referentiesnapshots zijn beschikbaar op
/v1-reference/openapi/<version>.json, bijvoorbeeld/v1-reference/openapi/2026-07-01.json.
Documentatie-updates
2026-08-25 — De handleidingen voor/v1 en de lijst met OpenAPI-servers noemen nu de actieve
regionale hosts voor de VS en de EU. Dit is een verduidelijking van de documentatie. De contractversie
is ongewijzigd. Zie Regio’s.
2026-07-01
De/v1 Public API ondersteunt deze contractversie. Leg de versie vast met
Living-Security-Version: 2026-07-01, of gebruik de standaardversie die aan uw serviceaccount is toegewezen.
Zie de API-quickstart voor uw eerste aanvraag,
Authenticatie voor API-sleutels en OAuth, en
Regio’s voor de juiste host.
2026-08-05
Deze datum identificeert het afzonderlijke legacy-/api/v1-compatibiliteitscontract.
Het is geen Living-Security-Version-waarde voor de nieuwe /v1-API.
- Mensen: zoek naar mensen in de organisatie (
GET /people/search) en haal het lidmaatschap van een persoon op (GET /people/{personId}/membership). - API-toegangssleutels: maak API-toegangssleutels aan, geef ze weer, roteer ze en trek ze in
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility. Zie het overzicht van de Public API voor
authenticatie, paginering en foutafhandeling, en het
beleid voor compatibiliteit en beëindiging van ondersteuning
voor de manier waarop dit contract zich ontwikkelt.
