> ## 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.

# Postman-gyűjtemény

> Importálja a generált Living Security Public API Postman-gyűjteményt, illessze be az API-kulcsot, és percek alatt hívhatja a /v1 végpontot.

A Living Security API v1 Postman-gyűjteménye ugyanabból az OpenAPI-specifikációból készül, amely az [API v1 referenciát](/v1-reference/openapi-v1.json) is működteti, így mindig megfelel a közzétett szerződésnek. Mind a(z) `/v1` műveletet lefedi erőforrások szerint csoportosítva, előre konfigurált hitelesítéssel.

## Letöltés

<Info>
  A letöltési hivatkozások a fájl kiszolgálása előtt a Living Security-fiókjával történő bejelentkezésre kérik.
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1 gyűjtemény" icon="download">
    Postman Collection v2.1 az összes `/v1` művelettel és előre konfigurált Basic hitelesítéssel. A(z) `baseUrl` gyűjtemény üres – kérés küldése előtt válasszon regionális környezetet.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">A gyűjtemény letöltése</a>
  </Card>

  <Card title="Éles (US) környezet" icon="download">
    `baseUrl` előre beállítva erre: `https://api.us-east-1.livingsecurity.ai/v1`, üres `apiKeySecret` és `contractVersion` változókkal, amelyeket ki kell töltenie.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Az amerikai éles környezet letöltése</a>
  </Card>

  <Card title="Éles (EU) környezet" icon="download">
    `baseUrl` előre beállítva erre: `https://api.eu-west-1.livingsecurity.ai/v1`, üres `apiKeySecret` és `contractVersion` változókkal, amelyeket ki kell töltenie.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Az európai éles környezet letöltése</a>
  </Card>

  <Card title="Környezetsablon" icon="download">
    Ugyanezek a változók üres `baseUrl` értékkel, nem éles környezetekhez.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">A környezetsablon letöltése</a>
  </Card>
</CardGroup>

## Beállítás a Postmanben

<Steps>
  <Step title="A fájlok importálása">
    A Postmanben válassza az **Import** lehetőséget, majd húzza be a gyűjtemény fájlját, valamint a szervezetnek megfelelő Production (US) vagy Production (EU) környezetet. Lásd: [Régiók](/hu/developers/v1/regions).
  </Step>

  <Step title="API-kulcs létrehozása">
    A Műszerfalon nyissa meg a **Beállítások → Integrációk & Developers → Developer Hub** menüpontot, hozzon létre egy szolgáltatásfiókot, majd hozzon létre egy API-kulcsot. A kulcs titkos értéke `lsk_live_` előtaggal kezdődik, és csak egyszer jelenik meg – azonnal másolja ki. További részletekért lásd: [API-kulcsok](/hu/developers/developer-hub/api-keys).
  </Step>

  <Step title="A titkos érték beillesztése">
    Állítsa be a(z) `apiKeySecret` változót – vagy az importált környezetben (ajánlott; titkos típusú változó), vagy a gyűjtemény **Variables** lapján.
  </Step>

  <Step title="Kérés küldése">
    Válassza ki az importált regionális környezetet, nyisson meg egy tetszőleges kérést – például az **Organization → Retrieve the organization** kérést –, majd kattintson a **Send** gombra. Ne küldjön kérést, amíg nincs kiválasztva környezet; a gyűjtemény `baseUrl` értéke szándékosan üres.
  </Step>
</Steps>

## Az előre konfigurált hitelesítés működése

A gyűjtemény a gyűjtemény szintjén Basic hitelesítést állít be, `apikey` felhasználónévvel és `{{apiKeySecret}}` jelszóval. Az API a kulcs titkos értékét bármelyik Basic hitelesítési mezőben elfogadja, így a változó beállítása után ez módosítás nélkül működik.

Ha a bearer hitelesítést részesíti előnyben, módosítsa a gyűjtemény **Authorization** típusát **Bearer Token** értékre, és tokenként használja a(z) `{{apiKeySecret}}` változót – az API mindkét módon ugyanazt a titkos értéket fogadja el.

API-kulccsal használt Bearer fejléc nem igényel OAuth-ot. OAuth használatához a **Bearer Token** mezőbe az API-kulcs titkos értéke helyett az OAuth hozzáférési tokent adja meg. A módszer kiválasztásához lásd: [Hitelesítés](/hu/developers/v1/authentication), a token és az ügyfél beállításához pedig: [OAuth client credentials](/hu/developers/v1/oauth).

## Szerződésverzió-fejléc

Minden kérés tartalmaz egy `Living-Security-Version` fejlécet, amely alapértelmezés szerint `{{contractVersion}}` értékre van állítva, és le van tiltva. Hagyja letiltva, ha a szervezet rögzített szerződésverzióját kívánja használni. Engedélyezze, ha a kérést egy adott közzétett verzióhoz szeretné rögzíteni – a közzétett verziókat lásd a [módosításnaplóban](/hu/developers/v1/changelog).

## Lekérdezési paraméterek és törzsek

A listavégpontok szűrői (`limit`, `page_token` és az erőforrás-specifikus szűrők) minden kérésben szerepelnek, de le vannak tiltva, így egy friss importálás után minden végpont sikeresen hívható. Engedélyezze és töltse ki a szükségeseket – a(z) `page_token` működéséről lásd: [Lapozás](/hu/developers/v1/pagination). A(z) `POST` műveletek kéréstörzsei típusos helyőrző értékekkel vannak előre kitöltve.

<Note>
  A gyűjtemény minden szerződésmódosításkor újragenerálódik a közzétett OpenAPI-specifikációból – az aktuális állapot megőrzéséhez töltsön le új másolatot ahelyett, hogy a kéréseket szerkesztené.
</Note>


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