Skip to main content
Public API Living Security використовує версії контракту на основі дат (YYYY-MM-DD). Опублікований документ OpenAPI містить версію свого контракту як info["x-contract-version"], а кожна операція вказує свій етап життєвого циклу як x-lifecycle-stage (preview, compatibility або ga).
  • Актуальна специфікація завжди доступна за адресою /v1-reference/openapi-v1.json.
  • Версійні знімки довідкової документації доступні за адресою /v1-reference/openapi/<version>.json, наприклад /v1-reference/openapi/2026-07-01.json.
Додаткові зміни, сумісні з попередніми версіями (нові операції, нові необов’язкові поля), випускаються в межах поточної версії контракту. Нова версія контракту публікується лише для несумісних змін разом із записом на цій сторінці, що описує зміну та шлях міграції.

​
Оновлення документації

2026-08-25 — У посібниках /v1 та списку servers OpenAPI тепер вказано чинні регіональні хости для США та ЄС. Це уточнення документації. Версія контракту не змінилася. Див. Regions.

​
2026-07-01

Public API /v1 підтримує цю версію контракту. Закріпіть її за допомогою Living-Security-Version: 2026-07-01 або скористайтеся версією за замовчуванням, призначеною вашому сервісному обліковому запису. Перший запит описано в API quickstart, ключі API та OAuth — в Authentication, а правильний хост — в Regions.

​
2026-08-05

Ця дата визначає окремий контракт сумісності /api/v1 попередньої версії. Це не значення Living-Security-Version для нового API /v1.
  • People: пошук користувачів організації (GET /people/search) та отримання інформації про належність користувача (GET /people/{personId}/membership).
  • API access keys: створення, перегляд списку, ротація та відкликання ключів доступу до API (POST /access-keys, GET /access-keys, POST /access-keys/{id}/rotate, DELETE /access-keys/{id}).
Усі операції в цій версії опубліковано на етапі життєвого циклу compatibility. Відомості про автентифікацію, пагінацію та обробку помилок див. в Public API overview, а про те, як розвивається цей контракт, — у політиці сумісності та застарівання.