YYYY-MM-DD). Opublikowany dokument OpenAPI zawiera wersję swojego kontraktu jako
info["x-contract-version"], a każda operacja określa swój etap cyklu życia
jako x-lifecycle-stage (preview, compatibility lub ga).
- Aktualna specyfikacja jest zawsze dostępna pod adresem
/v1-reference/openapi-v1.json. - Wersjonowane migawki dokumentacji referencyjnej są dostępne pod adresem
/v1-reference/openapi/<version>.json, na przykład/v1-reference/openapi/2026-07-01.json.
Aktualizacje dokumentacji
2026-08-25 — Przewodniki/v1 oraz lista servers w OpenAPI wskazują teraz
działające regionalne hosty w USA i UE. Jest to doprecyzowanie dokumentacji. Wersja kontraktu
pozostaje bez zmian. Zobacz Regiony.
2026-07-01
Publiczne API/v1 obsługuje tę wersję kontraktu. Przypnij ją za pomocą
Living-Security-Version: 2026-07-01 lub użyj wersji domyślnej przypisanej
do Twojego konta usługi.
Zobacz Krótki przewodnik po API, aby wykonać pierwsze żądanie,
Uwierzytelnianie, aby dowiedzieć się o kluczach API i OAuth, oraz
Regiony, aby poznać właściwy host.
2026-08-05
Ta data identyfikuje odrębny starszy kontrakt zgodności/api/v1.
Nie jest to wartość Living-Security-Version dla nowego API /v1.
- Ludzie: wyszukiwanie osób w organizacji (
GET /people/search) oraz pobieranie członkostwa danej osoby (GET /people/{personId}/membership). - Klucze dostępu do API: tworzenie, wyświetlanie, rotacja i unieważnianie kluczy dostępu do API
(
POST /access-keys,GET /access-keys,POST /access-keys/{id}/rotate,DELETE /access-keys/{id}).
compatibility.
Zobacz Przegląd publicznego API, aby zapoznać się z
uwierzytelnianiem, paginacją i obsługą błędów, oraz
politykę zgodności i wycofywania,
aby dowiedzieć się, jak ewoluuje ten kontrakt.
