> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Colecția Postman

> Importați colecția Postman generată pentru Living Security Public API, introduceți o cheie API și apelați /v1 în câteva minute.

Colecția Postman pentru Living Security API v1 este generată din aceeași
specificație OpenAPI care stă la baza [Referinței API v1](/v1-reference/openapi-v1.json),
astfel încât se potrivește întotdeauna cu contractul publicat. Aceasta acoperă toate operațiunile `/v1`,
grupate pe resurse, cu autentificarea preconfigurată.

## Descărcare

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

<CardGroup cols={1}>
  <Card title="Colecția Living Security API v1" icon="download">
    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.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Descărcați colecția</a>
  </Card>

  <Card title="Mediul de producție (SUA)" icon="download">
    `baseUrl` presetat la `https://api.us-east-1.livingsecurity.ai/v1`, cu
    variabilele `apiKeySecret` și `contractVersion` goale, pe care trebuie să le completați.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Descărcați mediul de producție pentru SUA</a>
  </Card>

  <Card title="Mediul de producție (UE)" icon="download">
    `baseUrl` presetat la `https://api.eu-west-1.livingsecurity.ai/v1`, cu
    variabilele `apiKeySecret` și `contractVersion` goale, pe care trebuie să le completați.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Descărcați mediul de producție pentru UE</a>
  </Card>

  <Card title="Șablon de mediu" icon="download">
    Aceleași variabile, cu un `baseUrl` necompletat, pentru configurări care nu sunt de producție.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Descărcați șablonul de mediu</a>
  </Card>
</CardGroup>

## Configurarea în Postman

<Steps>
  <Step title="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](/ro/developers/v1/regions).
  </Step>

  <Step title="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](/ro/developers/developer-hub/api-keys) pentru detalii.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## 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](/ro/developers/v1/authentication) pentru a alege o metodă și
[Credențiale de client OAuth](/ro/developers/v1/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](/ro/developers/v1/changelog)
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](/ro/developers/v1/pagination) 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.

<Note>
  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.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.