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

# Kolekcja Postman

> Zaimportuj wygenerowaną kolekcję Postman publicznego interfejsu API Living Security, wklej klucz API i w kilka minut wywołaj /v1.

Kolekcja Postman dla interfejsu Living Security API v1 jest generowana z tej samej
specyfikacji OpenAPI, na której opiera się [dokumentacja referencyjna API v1](/v1-reference/openapi-v1.json),
dzięki czemu zawsze odpowiada opublikowanemu kontraktowi. Obejmuje wszystkie operacje `/v1`,
pogrupowane według zasobów, z wstępnie skonfigurowanym uwierzytelnianiem.

## Pobieranie

<Info>
  Linki do pobrania wyświetlą monit o zalogowanie się na konto Living Security,
  zanim plik zostanie udostępniony.
</Info>

<CardGroup cols={1}>
  <Card title="Kolekcja Living Security API v1" icon="download">
    Kolekcja Postman w wersji 2.1 ze wszystkimi operacjami `/v1` i wstępnie skonfigurowanym uwierzytelnianiem Basic.
    Zmienna kolekcji `baseUrl` jest pusta — przed wysłaniem żądania wybierz środowisko
    regionalne.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Pobierz kolekcję</a>
  </Card>

  <Card title="Środowisko produkcyjne (US)" icon="download">
    `baseUrl` z wartością wstępnie ustawioną na `https://api.us-east-1.livingsecurity.ai/v1` oraz
    pustymi zmiennymi `apiKeySecret` i `contractVersion` do uzupełnienia.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Pobierz środowisko produkcyjne US</a>
  </Card>

  <Card title="Środowisko produkcyjne (EU)" icon="download">
    `baseUrl` z wartością wstępnie ustawioną na `https://api.eu-west-1.livingsecurity.ai/v1` oraz
    pustymi zmiennymi `apiKeySecret` i `contractVersion` do uzupełnienia.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Pobierz środowisko produkcyjne EU</a>
  </Card>

  <Card title="Szablon środowiska" icon="download">
    Te same zmienne z pustą wartością `baseUrl`, do konfiguracji nieprodukcyjnych.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Pobierz szablon środowiska</a>
  </Card>
</CardGroup>

## Konfiguracja w programie Postman

<Steps>
  <Step title="Zaimportuj pliki">
    W programie Postman wybierz **Importuj** i przeciągnij plik kolekcji oraz
    środowisko Production (US) lub Production (EU) odpowiadające
    organizacji. Zobacz [Regiony](/pl/developers/v1/regions).
  </Step>

  <Step title="Utwórz klucz API">
    W Pulpicie otwórz **Ustawienia → Integracje i Developer Hub →
    Developer Hub**, utwórz konto usługi, a następnie klucz API. Sekret klucza zaczyna się od `lsk_live_` i
    jest wyświetlany tylko raz — skopiuj go od razu. Szczegółowe informacje znajdziesz w sekcji
    [Klucze API](/pl/developers/developer-hub/api-keys).
  </Step>

  <Step title="Wklej sekret">
    Ustaw zmienną `apiKeySecret` — w zaimportowanym środowisku
    (zalecane; jest to zmienna typu secret) lub na karcie
    **Zmienne** kolekcji.
  </Step>

  <Step title="Wyślij żądanie">
    Wybierz zaimportowane środowisko regionalne, otwórz dowolne żądanie — na przykład
    **Organizacja → Retrieve the organization** — i kliknij **Wyślij**. Nie
    wysyłaj żądań, dopóki nie zostanie wybrane środowisko; zmienna kolekcji `baseUrl` jest celowo
    pusta.
  </Step>
</Steps>

## Jak wstępnie skonfigurowano uwierzytelnianie

Kolekcja ustawia uwierzytelnianie Basic na poziomie kolekcji z nazwą użytkownika `apikey`
i hasłem `{{apiKeySecret}}`. Interfejs API akceptuje sekret klucza w obu polach
uwierzytelniania Basic, więc po ustawieniu zmiennej rozwiązanie działa bez zmian.

Jeśli wolisz uwierzytelnianie typu bearer, zmień typ **Authorization** kolekcji
na **Bearer Token** i użyj `{{apiKeySecret}}` jako tokenu — interfejs API
akceptuje ten sam sekret w obu przypadkach.

Użycie nagłówka Bearer z kluczem API nie wymaga protokołu OAuth. Aby użyć OAuth,
ustaw w polu **Bearer Token** token dostępu OAuth zamiast sekretu klucza API.
Zobacz [Uwierzytelnianie](/pl/developers/v1/authentication), aby wybrać metodę, oraz
[OAuth client credentials](/pl/developers/v1/oauth), aby skonfigurować token i klienta.

## Nagłówek wersji kontraktu

Każde żądanie zawiera nagłówek `Living-Security-Version` z wartością wstępnie ustawioną na
`{{contractVersion}}`, domyślnie wyłączony. Pozostaw go wyłączonego, aby użyć przypiętej
wersji kontraktu Twojej organizacji. Włącz go, aby przypiąć żądanie do
konkretnej opublikowanej wersji — opublikowane wersje znajdziesz w [dzienniku zmian](/pl/developers/v1/changelog).

## Parametry zapytania i treści żądań

Filtry punktów końcowych list (`limit`, `page_token` oraz filtry specyficzne dla zasobu)
są dołączone do każdego żądania, ale wyłączone, dzięki czemu świeżo zaimportowana
kolekcja poprawnie wywołuje każdy punkt końcowy. Włącz i uzupełnij te, których potrzebujesz — zobacz
[Paginacja](/pl/developers/v1/pagination), aby dowiedzieć się, jak działa `page_token`. Treści
żądań operacji `POST` są wstępnie wypełnione typowanymi wartościami zastępczymi.

<Note>
  Kolekcja jest generowana ponownie z opublikowanej specyfikacji OpenAPI przy każdej
  zmianie kontraktu — pobierz nową kopię zamiast edytować żądania, które
  mają pozostać aktualne.
</Note>


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