> ## 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.

# Journal des modifications de l'API

> Versions de contrat et modifications de l'API publique de Living Security.

L'API publique de Living Security utilise des versions de contrat basées sur la date
(`YYYY-MM-DD`). Le document OpenAPI publié intègre sa version de contrat sous la forme
`info["x-contract-version"]`, et chaque opération déclare son stade de cycle de vie
sous la forme `x-lifecycle-stage` (`preview`, `compatibility` ou `ga`).

* La spécification actuelle est toujours disponible à l'adresse
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Des instantanés de référence versionnés sont disponibles à l'adresse
  `/v1-reference/openapi/<version>.json`, par exemple
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Les modifications additives et rétrocompatibles (nouvelles opérations, nouveaux champs facultatifs)
sont publiées au sein de la version de contrat actuelle. Une nouvelle version de contrat n'est publiée
que pour les modifications incompatibles, accompagnée d'une entrée sur cette page décrivant la
modification et la procédure de migration.

## Mises à jour de la documentation

**2026-08-25** — Les guides `/v1` et la liste `servers` d'OpenAPI mentionnent désormais les hôtes régionaux actifs
des États-Unis et de l'UE. Il s'agit d'une clarification de la documentation. La version
de contrat reste inchangée. Consultez [Régions](/fr/developers/v1/regions).

## 2026-07-01

L'API publique `/v1` prend en charge cette version de contrat. Épinglez-la à l'aide de
`Living-Security-Version: 2026-07-01`, ou utilisez la version par défaut attribuée
à votre compte de service.

Consultez le [guide de démarrage rapide de l'API](/fr/developers/v1/quickstart) pour votre première requête,
[Authentification](/fr/developers/v1/authentication) pour les clés d'API et OAuth, et
[Régions](/fr/developers/v1/regions) pour connaître l'hôte approprié.

## 2026-08-05

Cette date identifie le contrat de compatibilité `/api/v1` distinct et hérité.
Il ne s'agit pas d'une valeur `Living-Security-Version` pour la nouvelle API `/v1`.

* **Personnes** : recherchez les personnes de l'organisation (`GET /people/search`) et récupérez
  l'appartenance d'une personne (`GET /people/{personId}/membership`).
* **Clés d'accès à l'API** : créez, répertoriez, renouvelez et révoquez des clés d'accès à l'API
  (`POST /access-keys`, `GET /access-keys`, `POST /access-keys/{id}/rotate`,
  `DELETE /access-keys/{id}`).

Toutes les opérations de cette version sont publiées au stade de cycle de vie `compatibility`.
Consultez la [présentation de l'API publique](/fr/developers/public-api/overview) pour
l'authentification, la pagination et la gestion des erreurs, ainsi que la
[politique de compatibilité et d'obsolescence](/fr/developers/public-api/overview#compatibilit%C3%A9-et-d%C3%A9pr%C3%A9ciation)
pour savoir comment ce contrat évolue.


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