Skip to main content
De Postman-collectie voor de Living Security API v1 wordt gegenereerd op basis van dezelfde OpenAPI-specificatie waarop de API v1-referentie is gebaseerd, zodat deze altijd overeenkomt met het gepubliceerde contract. De collectie omvat alle /v1-bewerkingen, gegroepeerd per resource, met vooraf geconfigureerde authenticatie.

​
Downloaden

Bij de downloadlinks wordt u gevraagd u aan te melden met uw Living Security-account voordat het bestand wordt aangeboden.

Living Security API v1-collectie

Postman Collection v2.1 met alle /v1 bewerkingen en vooraf geconfigureerde Basic-authenticatie. Collectie baseUrl is leeg: selecteer een regionale omgeving voordat u een verzoek verzendt.Download de collectie

Productieomgeving (VS)

baseUrl vooraf ingesteld op https://api.us-east-1.livingsecurity.ai/v1, met lege variabelen apiKeySecret en contractVersion die u moet invullen.Download de productieomgeving voor de VS

Productieomgeving (EU)

baseUrl vooraf ingesteld op https://api.eu-west-1.livingsecurity.ai/v1, met lege variabelen apiKeySecret en contractVersion die u moet invullen.Download de productieomgeving voor de EU

Omgevingssjabloon

Dezelfde variabelen met een lege baseUrl, voor niet-productieomgevingen.Download het omgevingssjabloon

​
Instellen in Postman

1

De bestanden importeren

Kies in Postman Import en sleep het collectiebestand samen met de omgeving Production (US) of Production (EU) die bij uw organisatie past naar het venster. Zie Regio’s.
2

Een API-sleutel aanmaken

Open in het Dashboard Instellingen → Integraties & Developers → Developer Hub, maak een serviceaccount aan en maak vervolgens een API-sleutel aan. Het sleutelgeheim begint met lsk_live_ en wordt slechts één keer getoond: kopieer het direct. Zie API-sleutels voor meer informatie.
3

Het geheim plakken

Stel de variabele apiKeySecret in, hetzij in de geïmporteerde omgeving (aanbevolen; het is een variabele van het type secret), hetzij op het tabblad Variables van de collectie.
4

Een verzoek verzenden

Selecteer de geïmporteerde regionale omgeving, open een willekeurig verzoek, bijvoorbeeld Organization → Retrieve the organization, en klik op Send. Verzend geen verzoek zolang er geen omgeving is geselecteerd; de collectie baseUrl is bewust leeg.

​
Hoe authenticatie vooraf is geconfigureerd

De collectie stelt Basic-authenticatie in op collectieniveau in met gebruikersnaam apikey en wachtwoord {{apiKeySecret}}. De API accepteert het sleutelgeheim in beide Basic-authenticatievelden, dus dit werkt direct zodra de variabele is ingesteld. Als u de voorkeur geeft aan bearer-authenticatie, wijzigt u het type Authorization van de collectie in Bearer Token en gebruikt u {{apiKeySecret}} als token. De API accepteert hetzelfde geheim op beide manieren. Het gebruik van een Bearer-header met een API-sleutel vereist geen OAuth. Als u OAuth wilt gebruiken, stelt u Bearer Token in op uw OAuth-toegangstoken in plaats van het geheim van de API-sleutel. Zie Authenticatie om een methode te kiezen en OAuth client credentials voor de configuratie van tokens en clients.

​
Header voor contractversie

Elk verzoek bevat een header Living-Security-Version die vooraf is ingesteld op {{contractVersion}} en standaard is uitgeschakeld. Laat deze uitgeschakeld om de vastgezette contractversie van uw organisatie te gebruiken. Schakel deze in om het verzoek vast te zetten op een specifieke gepubliceerde versie. Zie het wijzigingslogboek voor gepubliceerde versies.

​
Queryparameters en bodies

Filters voor lijsteindpunten (limit, page_token en resourcespecifieke filters) zijn bij elk verzoek opgenomen maar uitgeschakeld, zodat een nieuw geïmporteerde collectie elk eindpunt succesvol aanroept. Schakel de filters die u nodig hebt in en vul ze in. Zie Paginering voor de werking van page_token. De request- bodies van POST-bewerkingen zijn vooraf ingevuld met getypeerde plaatshouderwaarden.
De collectie wordt bij elke contractwijziging opnieuw gegenereerd op basis van de gepubliceerde OpenAPI-specificatie. Download daarom een nieuwe kopie in plaats van verzoeken te bewerken die u actueel wilt houden.