Skip to main content
Colecția Postman pentru Living Security API v1 este generată din aceeași specificație OpenAPI care stă la baza Referinței API v1, astfel încât se potrivește întotdeauna cu contractul publicat. Aceasta acoperă toate operațiunile /v1, grupate pe resurse, cu autentificarea preconfigurată.

​
Descărcare

Linkurile de descărcare vă solicită să vă autentificați cu contul Living Security înainte ca fișierul să fie furnizat.

Colecția Living Security API v1

Colecție Postman v2.1 cu toate cele /v1 operațiuni și autentificarea Basic preconfigurată. Colecția baseUrl este necompletată — selectați un mediu regional înainte de a trimite o solicitare.Descărcați colecția

Mediul de producție (SUA)

baseUrl presetat la https://api.us-east-1.livingsecurity.ai/v1, cu variabilele apiKeySecret și contractVersion goale, pe care trebuie să le completați.Descărcați mediul de producție pentru SUA

Mediul de producție (UE)

baseUrl presetat la https://api.eu-west-1.livingsecurity.ai/v1, cu variabilele apiKeySecret și contractVersion goale, pe care trebuie să le completați.Descărcați mediul de producție pentru UE

Șablon de mediu

Aceleași variabile, cu un baseUrl necompletat, pentru configurări care nu sunt de producție.Descărcați șablonul de mediu

​
Configurarea în Postman

1

Importați fișierele

În Postman, alegeți Import și adăugați fișierul colecției, împreună cu mediul Production (US) sau Production (EU) care corespunde organizației. Consultați Regiuni.
2

Creați o cheie API

În Tablou de bord, deschideți Setări → Integrări & Developers → Developer Hub, creați un cont de serviciu și creați o cheie API. Secretul cheii începe cu lsk_live_ și este afișat o singură dată — copiați-l imediat. Consultați Chei API pentru detalii.
3

Introduceți secretul

Setați variabila apiKeySecret — fie în mediul importat (recomandat; este o variabilă de tip secret), fie în fila Variabile a colecției.
4

Trimiteți o solicitare

Selectați mediul regional importat, deschideți orice solicitare — de exemplu Organizație → Retrieve the organization — și faceți clic pe Trimitere. Nu trimiteți nimic până când nu este selectat un mediu; colecția baseUrl este necompletată intenționat.

​
Cum este preconfigurată autentificarea

Colecția setează autentificarea Basic la nivel de colecție, cu numele de utilizator apikey și parola {{apiKeySecret}}. API-ul acceptă secretul cheii în oricare dintre câmpurile de autentificare Basic, astfel încât funcționează ca atare odată ce variabila este setată. Dacă preferați autentificarea de tip bearer, schimbați tipul Authorization al colecției în Bearer Token și utilizați {{apiKeySecret}} ca token — API-ul acceptă același secret în ambele moduri. Utilizarea unui antet Bearer cu o cheie API nu necesită OAuth. Pentru a utiliza OAuth, setați Bearer Token la tokenul dvs. de acces OAuth, în locul secretului cheii API. Consultați Autentificare pentru a alege o metodă și Credențiale de client OAuth pentru configurarea tokenului și a clientului.

​
Antetul versiunii contractului

Fiecare solicitare include un antet Living-Security-Version presetat la {{contractVersion}}, dezactivat implicit. Lăsați-l dezactivat pentru a utiliza versiunea de contract fixată a organizației dvs. Activați-l pentru a fixa solicitarea la o anumită versiune publicată — consultați jurnalul de modificări pentru versiunile publicate.

​
Parametri de interogare și corpuri de solicitare

Filtrele endpointurilor de tip listă (limit, page_token și filtrele specifice resursei) sunt incluse în fiecare solicitare, dar dezactivate, astfel încât un import nou apelează fiecare endpoint cu succes. Activați și completați filtrele de care aveți nevoie — consultați Paginare pentru modul în care funcționează page_token. Corpurile solicitărilor pentru operațiunile POST sunt completate în prealabil cu valori de substituție tipizate.
Colecția este regenerată din specificația OpenAPI publicată la fiecare modificare a contractului — descărcați o copie nouă în loc să editați solicitările pe care doriți să le mențineți la zi.