YYYY-MM-DD). A közzétett OpenAPI-dokumentum a szerződés verzióját info["x-contract-version"] értékként tartalmazza, és minden művelet az életciklus-szakaszát
x-lifecycle-stage értékként adja meg (preview, compatibility vagy ga).
- Az aktuális specifikáció mindig elérhető a következő címen:
/v1-reference/openapi-v1.json. - A verziózott referencia-pillanatképek a következő helyen érhetők el:
/v1-reference/openapi/<version>.json, például/v1-reference/openapi/2026-07-01.json.
Dokumentációfrissítések
2026-08-25 — A/v1 útmutatók és az OpenAPI servers lista mostantól az éles
amerikai és európai regionális gazdagépeket nevezi meg. Ez dokumentációs pontosítás. A szerződés
verziója nem változott. Lásd: Régiók.
2026-07-01
A/v1 nyilvános API támogatja ezt a szerződésverziót. Rögzítse a
Living-Security-Version: 2026-07-01 használatával, vagy használja a szolgáltatásfiókjához rendelt alapértelmezett verziót.
Az első kéréshez lásd az API gyorsútmutatót, az API-kulcsokhoz és az OAuth-hoz a Hitelesítést, a megfelelő gazdagéphez pedig a Régiókat.
2026-08-05
Ez a dátum a különálló, örökölt/api/v1 kompatibilitási szerződést azonosítja.
Nem Living-Security-Version érték az új /v1 API-hoz.
- Emberek: a szervezet tagjainak keresése (
GET /people/search) és egy személy tagságának lekérdezése (GET /people/{personId}/membership). - API-hozzáférési kulcsok: API-hozzáférési kulcsok létrehozása, listázása, cseréje és visszavonása
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility életciklus-szakaszban van közzétéve. A hitelesítésről, lapozásról és hibakezelésről lásd a nyilvános API áttekintését, a szerződés fejlődéséről pedig a
kompatibilitási és elavulási szabályzatot.
