Skip to main content
Postman-samlingen för Living Security API v1 genereras från samma OpenAPI-specifikation som ligger till grund för API v1-referensen, så den stämmer alltid överens med det publicerade kontraktet. Den omfattar alla /v1-operationer, grupperade efter resurs, med förkonfigurerad autentisering.

​
Ladda ned

Nedladdningslänkarna uppmanar dig att logga in med ditt Living Security-konto innan filen levereras.

Living Security API v1-samling

Postman Collection v2.1 med alla /v1 operationer och förkonfigurerad Basic-autentisering. Samlingens baseUrl är tom – välj en regional miljö innan du skickar en begäran.Ladda ned samlingen

Produktionsmiljö (US)

baseUrl är förinställd på https://api.us-east-1.livingsecurity.ai/v1, med tomma variabler för apiKeySecret och contractVersion som ska fyllas i.Ladda ned produktionsmiljön för US

Produktionsmiljö (EU)

baseUrl är förinställd på https://api.eu-west-1.livingsecurity.ai/v1, med tomma variabler för apiKeySecret och contractVersion som ska fyllas i.Ladda ned produktionsmiljön för EU

Miljömall

Samma variabler med en tom baseUrl, för icke-produktionsmiljöer.Ladda ned miljömallen

​
Konfigurera i Postman

1

Importera filerna

Välj Importera i Postman och släpp in samlingsfilen samt den produktionsmiljö (US eller EU) som motsvarar organisationen. Se Regioner.
2

Skapa en API-nyckel

Öppna Inställningar → Integrationer & Developers → Developer Hub i Instrumentpanel, skapa ett tjänstkonto och skapa en API-nyckel. Nyckelns hemlighet börjar med lsk_live_ och visas bara en gång – kopiera den direkt. Se API-nycklar för mer information.
3

Klistra in hemligheten

Ange variabeln apiKeySecret – antingen i den importerade miljön (rekommenderas; det är en variabel av typen hemlighet) eller på samlingens flik Variables.
4

Skicka en begäran

Välj den importerade regionala miljön, öppna valfri begäran – till exempel Organization → Retrieve the organization – och klicka på Skicka. Skicka inte något förrän en miljö har valts; samlingens baseUrl är avsiktligt tom.

​
Så här är autentiseringen förkonfigurerad

Samlingen anger Basic-autentisering på samlingsnivå med användarnamnet apikey och lösenordet {{apiKeySecret}}. API:et accepterar nyckelns hemlighet i något av Basic-autentiseringens fält, så detta fungerar direkt när variabeln har angetts. Om du föredrar Bearer-autentisering ändrar du samlingens Authorization-typ till Bearer Token och använder {{apiKeySecret}} som token – API:et accepterar samma hemlighet på båda sätten. Att använda en Bearer-header med en API-nyckel kräver inte OAuth. Om du vill använda OAuth anger du din OAuth-åtkomsttoken i Bearer Token i stället för nyckelns hemlighet. Se Autentisering för att välja metod och OAuth-klientuppgifter för konfiguration av token och klient.

​
Header för kontraktsversion

Varje begäran har en Living-Security-Version-header som är förinställd på {{contractVersion}} och som är inaktiverad som standard. Låt den vara inaktiverad för att använda din organisations fastlåsta kontraktsversion. Aktivera den för att låsa begäran till en specifik publicerad version – se ändringsloggen för publicerade versioner.

​
Frågeparametrar och innehåll

Filter för liständpunkter (limit, page_token samt resursspecifika filter) finns med i varje begäran men är inaktiverade, så att en nyimporterad samling anropar varje ändpunkt utan fel. Aktivera och fyll i de som du behöver – se Paginering för hur page_token fungerar. Begärans innehåll för POST-operationer är förifyllt med typade platshållarvärden.
Samlingen genereras om från den publicerade OpenAPI-specifikationen vid varje kontraktsändring – ladda ned en ny kopia i stället för att redigera begäranden som du vill hålla aktuella.