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

# Postman-kokoelma

> Tuo luotu Living Security Public API -Postman-kokoelma, liitä API-avain ja kutsu /v1-rajapintaa muutamassa minuutissa.

Living Security API v1 -Postman-kokoelma luodaan samasta OpenAPI-määrityksestä,
joka toimii [API v1 -viitteen](/v1-reference/openapi-v1.json) perustana,
joten se vastaa aina julkaistua rajapintasopimusta. Se kattaa kaikki `/v1` operaatiota
resurssien mukaan ryhmiteltyinä, ja todennus on valmiiksi määritetty.

## Lataus

<Info>
  Latauslinkit pyytävät sinua kirjautumaan sisään Living Security -tililläsi,
  ennen kuin tiedosto toimitetaan.
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1 -kokoelma" icon="download">
    Postman Collection v2.1, jossa on kaikki `/v1` operaatiota ja Basic-todennus
    valmiiksi määritettynä. Kokoelman `baseUrl` on tyhjä – valitse alueellinen
    ympäristö, ennen kuin lähetät pyynnön.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Lataa kokoelma</a>
  </Card>

  <Card title="Tuotantoympäristö (US)" icon="download">
    `baseUrl` on esimääritetty arvoon `https://api.us-east-1.livingsecurity.ai/v1`, ja
    tyhjät muuttujat `apiKeySecret` ja `contractVersion` odottavat täyttämistä.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Lataa US-tuotantoympäristö</a>
  </Card>

  <Card title="Tuotantoympäristö (EU)" icon="download">
    `baseUrl` on esimääritetty arvoon `https://api.eu-west-1.livingsecurity.ai/v1`, ja
    tyhjät muuttujat `apiKeySecret` ja `contractVersion` odottavat täyttämistä.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Lataa EU-tuotantoympäristö</a>
  </Card>

  <Card title="Ympäristömalli" icon="download">
    Samat muuttujat tyhjällä `baseUrl`-arvolla ei-tuotantoympäristöjä varten.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Lataa ympäristömalli</a>
  </Card>
</CardGroup>

## Käyttöönotto Postmanissa

<Steps>
  <Step title="Tuo tiedostot">
    Valitse Postmanissa **Import** ja lisää kokoelmatiedosto sekä
    organisaatiotasi vastaava Production (US) - tai Production (EU) -ympäristö.
    Katso [Alueet](/fi/developers/v1/regions).
  </Step>

  <Step title="Luo API-avain">
    Avaa Kojelaudassa **Asetukset → Integraatiot & Kehittäjät →
    Developer Hub**, luo palvelutili ja luo sille API-avain. Avaimen salaisuus alkaa merkinnällä `lsk_live_` ja
    näytetään vain kerran – kopioi se heti. Lisätietoja on kohdassa
    [API-avaimet](/fi/developers/developer-hub/api-keys).
  </Step>

  <Step title="Liitä salaisuus">
    Aseta muuttuja `apiKeySecret` joko tuodussa ympäristössä
    (suositeltu; se on salaisuustyyppinen muuttuja) tai kokoelman
    **Variables**-välilehdellä.
  </Step>

  <Step title="Lähetä pyyntö">
    Valitse tuotu alueellinen ympäristö, avaa mikä tahansa pyyntö – esimerkiksi
    **Organization → Retrieve the organization** – ja valitse **Send**. Älä
    lähetä pyyntöä, ennen kuin ympäristö on valittu; kokoelman `baseUrl` on tyhjä
    tarkoituksella.
  </Step>
</Steps>

## Näin todennus on määritetty valmiiksi

Kokoelmassa Basic-todennus on määritetty kokoelmatasolla käyttäjätunnuksella `apikey`
ja salasanalla `{{apiKeySecret}}`. Rajapinta hyväksyy avaimen salaisuuden kummassa tahansa
Basic-todennuksen kentässä, joten tämä toimii sellaisenaan, kun muuttuja on asetettu.

Jos haluat käyttää bearer-todennusta, vaihda kokoelman **Authorization**-tyypiksi
**Bearer Token** ja käytä tunnisteena arvoa `{{apiKeySecret}}` – rajapinta
hyväksyy saman salaisuuden kummallakin tavalla.

Bearer-otsikon käyttäminen API-avaimen kanssa ei edellytä OAuthia. Jos haluat käyttää OAuthia,
aseta **Bearer Token** -arvoksi OAuth-käyttöoikeustunnisteesi API-avaimen salaisuuden sijaan.
Katso todennustavan valinta kohdasta [Todennus](/fi/developers/v1/authentication) ja
tunnisteen ja asiakkaan määritys kohdasta [OAuth-asiakastunnukset](/fi/developers/v1/oauth).

## Rajapintasopimuksen versio -otsikko

Jokaisessa pyynnössä on `Living-Security-Version`-otsikko, jonka esiasetettu arvo on
`{{contractVersion}}` ja joka on oletuksena pois käytöstä. Jätä se pois käytöstä, jos haluat käyttää
organisaatiosi kiinnitettyä rajapintasopimuksen versiota. Ota se käyttöön, jos haluat kiinnittää pyynnön
tiettyyn julkaistuun versioon – julkaistut versiot ovat
[muutoslokissa](/fi/developers/v1/changelog).

## Kyselyparametrit ja pyyntöjen rungot

Luettelopäätepisteiden suodattimet (`limit`, `page_token` ja resurssikohtaiset suodattimet)
sisältyvät jokaiseen pyyntöön, mutta ne ovat pois käytöstä, joten tuore tuonti kutsuu jokaista
päätepistettä onnistuneesti. Ota tarvitsemasi käyttöön ja täytä ne – lisätietoja kohdasta
[Sivutus](/fi/developers/v1/pagination) siitä, miten `page_token` toimii. Operaatioiden `POST` pyyntöjen rungot
on esitäytetty tyypitetyillä paikkamerkkiarvoilla.

<Note>
  Kokoelma luodaan uudelleen julkaistusta OpenAPI-määrityksestä jokaisen
  rajapintasopimuksen muutoksen yhteydessä – lataa uusi kopio sen sijaan, että
  muokkaisit pyyntöjä, joiden haluat pysyä ajan tasalla.
</Note>


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