Skip to main content
Living Security API v1 -Postman-kokoelma luodaan samasta OpenAPI-määrityksestä, joka toimii API v1 -viitteen perustana, joten se vastaa aina julkaistua rajapintasopimusta. Se kattaa kaikki /v1 operaatiota resurssien mukaan ryhmiteltyinä, ja todennus on valmiiksi määritetty.

​
Lataus

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

Living Security API v1 -kokoelma

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.Lataa kokoelma

Tuotantoympäristö (US)

baseUrl on esimääritetty arvoon https://api.us-east-1.livingsecurity.ai/v1, ja tyhjät muuttujat apiKeySecret ja contractVersion odottavat täyttämistä.Lataa US-tuotantoympäristö

Tuotantoympäristö (EU)

baseUrl on esimääritetty arvoon https://api.eu-west-1.livingsecurity.ai/v1, ja tyhjät muuttujat apiKeySecret ja contractVersion odottavat täyttämistä.Lataa EU-tuotantoympäristö

Ympäristömalli

Samat muuttujat tyhjällä baseUrl-arvolla ei-tuotantoympäristöjä varten.Lataa ympäristömalli

​
Käyttöönotto Postmanissa

1

Tuo tiedostot

Valitse Postmanissa Import ja lisää kokoelmatiedosto sekä organisaatiotasi vastaava Production (US) - tai Production (EU) -ympäristö. Katso Alueet.
2

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

Liitä salaisuus

Aseta muuttuja apiKeySecret joko tuodussa ympäristössä (suositeltu; se on salaisuustyyppinen muuttuja) tai kokoelman Variables-välilehdellä.
4

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.

​
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 ja tunnisteen ja asiakkaan määritys kohdasta OAuth-asiakastunnukset.

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

​
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 siitä, miten page_token toimii. Operaatioiden POST pyyntöjen rungot on esitäytetty tyypitetyillä paikkamerkkiarvoilla.
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.