Skip to main content
Postman-samlingen til Living Security API v1 genereres ud fra den samme OpenAPI-specifikation, som ligger til grund for API v1-referencen, så den altid svarer til den offentliggjorte kontrakt. Den dækker alle /v1-operationer, grupperet efter ressource, med forudkonfigureret godkendelse.

Download

Downloadlinkene beder dig om at logge ind med din Living Security-konto, før filen leveres.

Living Security API v1-samling

Postman Collection v2.1 med alle /v1-operationer og forudkonfigureret Basic-godkendelse. Samlingens baseUrl er tom – vælg et regionalt miljø, før du sender en anmodning.Download samlingen

Produktionsmiljø (US)

baseUrl er forudindstillet til https://api.us-east-1.livingsecurity.ai/v1, med tomme variabler for apiKeySecret og contractVersion, som skal udfyldes.Download produktionsmiljøet for US

Produktionsmiljø (EU)

baseUrl er forudindstillet til https://api.eu-west-1.livingsecurity.ai/v1, med tomme variabler for apiKeySecret og contractVersion, som skal udfyldes.Download produktionsmiljøet for EU

Miljøskabelon

De samme variabler med en tom baseUrl, til opsætninger uden for produktion.Download miljøskabelonen

Opsætning i Postman

1

Importér filerne

Vælg Import i Postman, og træk samlingsfilen ind sammen med det miljø, Production (US) eller Production (EU), der svarer til organisationen. Se Regioner.
2

Opret en API-nøgle

Åbn Indstillinger → Integrationer & Developers → Developer Hub i Dashboard, opret en tjenestekonto, og opret en API-nøgle. Nøglens hemmelighed begynder med lsk_live_ og vises kun én gang – kopiér den med det samme. Se API-nøgler for flere oplysninger.
3

Indsæt hemmeligheden

Angiv variablen apiKeySecret – enten i det importerede miljø (anbefales; det er en variabel af typen secret) eller på samlingens fane Variables.
4

Send en anmodning

Vælg det importerede regionale miljø, åbn en vilkårlig anmodning – for eksempel Organization → Retrieve the organization – og klik på Send. Send ikke, før et miljø er valgt. Samlingens baseUrl er tom med vilje.

Sådan er godkendelse forudkonfigureret

Samlingen angiver Basic-godkendelse på samlingsniveau med brugernavnet apikey og adgangskoden {{apiKeySecret}}. API’et accepterer nøglens hemmelighed i begge Basic-godkendelsesfelter, så det fungerer uændret, når variablen er angivet. Hvis du foretrækker bearer-godkendelse, skal du ændre samlingens Authorization-type til Bearer Token og bruge {{apiKeySecret}} som token – API’et accepterer den samme hemmelighed begge veje. Brug af en Bearer-header med en API-nøgle kræver ikke OAuth. Hvis du vil bruge OAuth, skal du i stedet angive din OAuth-adgangstoken i Bearer Token i stedet for API-nøglens hemmelighed. Se Godkendelse for at vælge en metode og OAuth client credentials for opsætning af token og klient.

Header for kontraktversion

Hver anmodning indeholder en Living-Security-Version-header, der er forudindstillet til {{contractVersion}}, og som er deaktiveret som standard. Lad den være deaktiveret for at bruge din organisations fastlåste kontraktversion. Aktivér den for at fastlåse anmodningen til en bestemt offentliggjort version – se ændringsloggen for offentliggjorte versioner.

Forespørgselsparametre og brødtekster

Filtre til listeendepunkter (limit, page_token og ressourcespecifikke filtre) er inkluderet på hver anmodning, men deaktiveret, så en ny import kalder hvert endepunkt uden fejl. Aktivér og udfyld dem, du har brug for – se Paginering for, hvordan page_token fungerer. Anmodningens brødtekster for POST-operationer er forudfyldt med typede pladsholderværdier.
Samlingen genereres på ny ud fra den offentliggjorte OpenAPI-specifikation ved hver ændring af kontrakten – download en ny kopi i stedet for at redigere anmodninger, du vil holde ajour.