YYYY-MM-DD). Det publicerade OpenAPI-dokumentet bäddar in sin kontraktsversion som
info["x-contract-version"], och varje operation anger sitt livscykelsteg
som x-lifecycle-stage (preview, compatibility eller ga).
- Den aktuella specifikationen finns alltid tillgänglig på
/v1-reference/openapi-v1.json. - Versionsbundna referensögonblicksbilder finns tillgängliga på
/v1-reference/openapi/<version>.json, till exempel/v1-reference/openapi/2026-07-01.json.
Dokumentationsuppdateringar
2026-08-25 — Guiderna för/v1 och OpenAPI-listan servers anger nu de aktiva regionala
värdarna för USA och EU. Detta är ett förtydligande i dokumentationen. Kontraktsversionen
är oförändrad. Se Regioner.
2026-07-01
Public API för/v1 stöder den här kontraktsversionen. Fäst den med
Living-Security-Version: 2026-07-01, eller använd standardversionen som är tilldelad
ditt tjänstkonto.
Se API-snabbstart för din första förfrågan,
Autentisering för API-nycklar och OAuth samt
Regioner för rätt värd.
2026-08-05
Det här datumet identifierar det separata äldre kompatibilitetskontraktet för/api/v1.
Det är inte ett Living-Security-Version-värde för det nya API:et /v1.
- Människor: sök bland organisationens människor (
GET /people/search) och hämta en persons medlemskap (GET /people/{personId}/membership). - API-åtkomstnycklar: skapa, lista, rotera och återkalla API-åtkomstnycklar
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility. Se översikten över Public API för
autentisering, paginering och felhantering samt
policyn för kompatibilitet och utfasning
för hur det här kontraktet utvecklas.
