Skip to main content
Living Security Public API использует версии контракта, основанные на датах (YYYY-MM-DD). Опубликованный документ OpenAPI содержит версию своего контракта в виде info["x-contract-version"], а каждая операция указывает свой этап жизненного цикла в поле x-lifecycle-stage (preview, compatibility или ga). Дополняющие изменения, обратно совместимые (новые операции, новые необязательные поля), выпускаются в рамках текущей версии контракта. Новая версия контракта публикуется только при внесении критических изменений вместе с записью на этой странице, в которой описываются изменение и порядок миграции.

​
Обновления документации

2026-08-25 — В руководствах /v1 и списке servers OpenAPI теперь указаны действующие региональные хосты для США и ЕС. Это уточнение документации. Версия контракта не изменилась. См. раздел Регионы.

​
2026-07-01

Эта версия контракта поддерживается в /v1 Public API. Зафиксируйте её с помощью Living-Security-Version: 2026-07-01 или используйте версию по умолчанию, назначенную вашей сервисной учётной записи. Сведения о первом запросе см. в кратком руководстве по API, об API-ключах и OAuth — в разделе Аутентификация, о выборе правильного хоста — в разделе Регионы.

​
2026-08-05

Эта дата обозначает отдельный контракт обратной совместимости /api/v1 прежней версии. Это не значение Living-Security-Version для нового API /v1.
  • Люди: поиск людей в организации (GET /people/search) и получение данных о членстве человека (GET /people/{personId}/membership).
  • Ключи доступа к API: создание, просмотр списка, ротация и отзыв ключей доступа к API (POST /access-keys, GET /access-keys, POST /access-keys/{id}/rotate, DELETE /access-keys/{id}).
Все операции в этой версии опубликованы на этапе жизненного цикла compatibility. Сведения об аутентификации, постраничной выдаче и обработке ошибок см. в обзоре Public API, а о том, как развивается этот контракт, — в политике совместимости и прекращения поддержки.