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

> Living Security Public API -rajapinnan sopimusversiot ja muutokset.

Living Security Public API käyttää päivämääräpohjaisia sopimusversioita
(`YYYY-MM-DD`). Julkaistu OpenAPI-dokumentti sisältää sopimusversionsa kohdassa
`info["x-contract-version"]`, ja jokainen operaatio ilmoittaa elinkaarensa vaiheen
kohdassa `x-lifecycle-stage` (`preview`, `compatibility` tai `ga`).

* Nykyinen määrittely on aina saatavilla osoitteessa
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Versioidut viitekuvat ovat saatavilla osoitteessa
  `/v1-reference/openapi/<version>.json`, esimerkiksi
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Lisäävät, taaksepäin yhteensopivat muutokset (uudet operaatiot, uudet valinnaiset kentät)
julkaistaan nykyisen sopimusversion sisällä. Uusi sopimusversio julkaistaan
vain yhteensopimattomien muutosten yhteydessä, ja sen mukana tälle sivulle lisätään merkintä,
jossa kuvataan muutos ja siirtymäpolku.

## Dokumentaatiopäivitykset

**2026-08-25** — Oppaat (`/v1`) ja OpenAPI-luettelo (`servers`) nimeävät nyt käytössä olevat
alueelliset Yhdysvaltojen ja EU:n isännät. Kyseessä on dokumentaation täsmennys. Sopimusversio
pysyy ennallaan. Katso [Alueet](/fi/developers/v1/regions).

## 2026-07-01

`/v1` Public API tukee tätä sopimusversiota. Kiinnitä versio
käyttämällä kohtaa `Living-Security-Version: 2026-07-01` tai käytä palvelutilillesi
määritettyä oletusversiota.

Katso ensimmäistä pyyntöäsi varten [API:n pikaopas](/fi/developers/v1/quickstart),
API-avaimia ja OAuthia varten [Todennus](/fi/developers/v1/authentication) ja
oikeaa isäntää varten [Alueet](/fi/developers/v1/regions).

## 2026-08-05

Tämä päivämäärä tunnistaa erillisen vanhan `/api/v1`-yhteensopivuussopimuksen.
Se ei ole `Living-Security-Version`-arvo uudelle `/v1` API:lle.

* **Ihmiset**: hae organisaation henkilöitä (`GET /people/search`) ja nouda
  henkilön jäsenyys (`GET /people/{personId}/membership`).
* **API-käyttöavaimet**: luo, listaa, vaihda ja peruuta API-käyttöavaimia
  (`POST /access-keys`, `GET /access-keys`, `POST /access-keys/{id}/rotate`,
  `DELETE /access-keys/{id}`).

Kaikki tämän version operaatiot julkaistaan elinkaaren vaiheessa `compatibility`. Katso
todennusta, sivutusta ja virheenkäsittelyä varten [Public API:n yleiskatsaus](/fi/developers/public-api/overview) ja
sopimuksen kehittymisestä
[yhteensopivuus- ja käytöstäpoistokäytäntö](/fi/developers/public-api/overview#yhteensopivuus-ja-k%C3%A4yt%C3%B6st%C3%A4-poistaminen).


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