> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Журнал изменений API

> Версии контракта и изменения в Living Security Public API.

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

* Актуальная спецификация всегда доступна по адресу
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Версионированные снимки справочника доступны по адресу
  `/v1-reference/openapi/<version>.json`, например
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Дополняющие изменения, обратно совместимые (новые операции, новые необязательные поля),
выпускаются в рамках текущей версии контракта. Новая версия контракта публикуется
только при внесении критических изменений вместе с записью на этой странице, в которой описываются
изменение и порядок миграции.

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

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

## 2026-07-01

Эта версия контракта поддерживается в `/v1` Public API. Зафиксируйте её с помощью
`Living-Security-Version: 2026-07-01` или используйте версию по умолчанию, назначенную
вашей сервисной учётной записи.

Сведения о первом запросе см. в [кратком руководстве по API](/ru/developers/v1/quickstart),
об API-ключах и OAuth — в разделе [Аутентификация](/ru/developers/v1/authentication),
о выборе правильного хоста — в разделе [Регионы](/ru/developers/v1/regions).

## 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](/ru/developers/public-api/overview),
а о том, как развивается этот контракт, — в
[политике совместимости и прекращения поддержки](/ru/developers/public-api/overview#%D1%81%D0%BE%D0%B2%D0%BC%D0%B5%D1%81%D1%82%D0%B8%D0%BC%D0%BE%D1%81%D1%82%D1%8C-%D0%B8-%D0%BF%D1%80%D0%B5%D0%BA%D1%80%D0%B0%D1%89%D0%B5%D0%BD%D0%B8%D0%B5-%D0%BF%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%BA%D0%B8).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.