Skip to main content
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). 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.

​
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, API-avaimia ja OAuthia varten Todennus ja oikeaa isäntää varten Alueet.

​
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 ja sopimuksen kehittymisestä yhteensopivuus- ja käytöstäpoistokäytäntö.