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

# Kolekce Postman

> Naimportujte vygenerovanou kolekci Postman pro veřejné rozhraní Living Security Public API, vložte klíč API a během několika minut volejte /v1.

Kolekce Postman pro rozhraní Living Security API v1 je generována ze stejné
specifikace OpenAPI, ze které vychází [reference API v1](/v1-reference/openapi-v1.json),
takže vždy odpovídá zveřejněné smluvní definici. Pokrývá všechny operace `/v1`,
seskupené podle zdrojů, s předkonfigurovaným ověřováním.

## Stažení

<Info>
  Před zpřístupněním souboru se u odkazů ke stažení zobrazí výzva
  k přihlášení pomocí účtu Living Security.
</Info>

<CardGroup cols={1}>
  <Card title="Kolekce Living Security API v1" icon="download">
    Postman Collection v2.1 se všemi operacemi `/v1` a předkonfigurovaným
    ověřováním Basic. Kolekce `baseUrl` je prázdná – před odesláním požadavku
    vyberte regionální prostředí.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Stáhnout kolekci</a>
  </Card>

  <Card title="Produkční prostředí (USA)" icon="download">
    `baseUrl` přednastavená na `https://api.us-east-1.livingsecurity.ai/v1`, s
    prázdnými proměnnými `apiKeySecret` a `contractVersion`, které je třeba vyplnit.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Stáhnout produkční prostředí pro USA</a>
  </Card>

  <Card title="Produkční prostředí (EU)" icon="download">
    `baseUrl` přednastavená na `https://api.eu-west-1.livingsecurity.ai/v1`, s
    prázdnými proměnnými `apiKeySecret` a `contractVersion`, které je třeba vyplnit.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Stáhnout produkční prostředí pro EU</a>
  </Card>

  <Card title="Šablona prostředí" icon="download">
    Stejné proměnné s prázdnou hodnotou `baseUrl`, pro neprodukční konfigurace.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Stáhnout šablonu prostředí</a>
  </Card>
</CardGroup>

## Nastavení v aplikaci Postman

<Steps>
  <Step title="Import souborů">
    V aplikaci Postman zvolte **Import** a přetáhněte soubor kolekce spolu
    s produkčním prostředím (USA) nebo produkčním prostředím (EU), které
    odpovídá vaší organizaci. Viz [Regiony](/cs/developers/v1/regions).
  </Step>

  <Step title="Vytvoření klíče API">
    Na Nástěnce otevřete **Nastavení → Integrace & Developers →
    Developer Hub**, vytvořte servisní účet a poté klíč API. Tajný klíč začíná `lsk_live_` a
    zobrazí se pouze jednou – ihned si jej zkopírujte. Podrobnosti najdete v části
    [Klíče API](/cs/developers/developer-hub/api-keys).
  </Step>

  <Step title="Vložení tajného klíče">
    Nastavte proměnnou `apiKeySecret` – buď v naimportovaném prostředí
    (doporučeno; jde o proměnnou typu secret), nebo na kartě
    **Proměnné** v kolekci.
  </Step>

  <Step title="Odeslání požadavku">
    Vyberte naimportované regionální prostředí, otevřete libovolný požadavek – například
    **Organizace → Retrieve the organization** – a klikněte na **Odeslat**. Neodesílejte
    požadavky, dokud není vybráno prostředí; proměnná kolekce `baseUrl` je
    záměrně prázdná.
  </Step>
</Steps>

## Jak je předkonfigurováno ověřování

Kolekce nastavuje ověřování Basic na úrovni kolekce s uživatelským jménem `apikey`
a heslem `{{apiKeySecret}}`. Rozhraní API přijímá tajný klíč v obou polích
ověřování Basic, takže po nastavení proměnné funguje bez dalších úprav.

Pokud dáváte přednost ověřování typu bearer, změňte typ **Authorization**
v kolekci na **Bearer Token** a jako token použijte `{{apiKeySecret}}` – rozhraní API
přijímá stejný tajný klíč oběma způsoby.

Použití hlavičky Bearer s klíčem API nevyžaduje OAuth. Pokud chcete použít OAuth,
nastavte do pole **Bearer Token** místo tajného klíče API svůj přístupový token OAuth.
Výběr metody najdete v části [Ověřování](/cs/developers/v1/authentication)
a nastavení tokenu a klienta v části [Přihlašovací údaje klienta OAuth](/cs/developers/v1/oauth).

## Hlavička verze smlouvy

Každý požadavek obsahuje hlavičku `Living-Security-Version` přednastavenou na
`{{contractVersion}}`, která je ve výchozím stavu zakázána. Ponecháte-li ji zakázanou, použije se
verze smlouvy připnutá pro vaši organizaci. Jejím povolením připnete požadavek ke
konkrétní zveřejněné verzi – zveřejněné verze najdete v [seznamu změn](/cs/developers/v1/changelog).

## Parametry dotazu a těla požadavků

Filtry koncových bodů se seznamy (`limit`, `page_token` a filtry specifické pro daný zdroj)
jsou součástí každého požadavku, ale jsou zakázané, takže čerstvě naimportovaná kolekce
úspěšně volá každý koncový bod. Povolte a vyplňte ty, které potřebujete – jak funguje `page_token`,
popisuje část [Stránkování](/cs/developers/v1/pagination). Těla požadavků
u operací `POST` jsou předvyplněna zástupnými hodnotami příslušných typů.

<Note>
  Kolekce se znovu generuje z publikované specifikace OpenAPI při každé změně
  smlouvy – místo úprav požadavků, které chcete udržovat aktuální, si stáhněte
  novou kopii.
</Note>


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