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

> Importieren Sie die generierte Postman-Collection der Living Security Public API, fügen Sie einen API-Schlüssel ein und rufen Sie /v1 in wenigen Minuten auf.

Die Postman-Collection für die Living Security API v1 wird aus derselben
OpenAPI-Spezifikation generiert, auf der auch die [API-v1-Referenz](/v1-reference/openapi-v1.json) basiert,
und entspricht daher stets dem veröffentlichten Vertrag. Sie deckt alle `/v1` Operationen ab,
gruppiert nach Ressourcen, mit vorkonfigurierter Authentifizierung.

## Download

<Info>
  Die Download-Links fordern Sie auf, sich mit Ihrem Living Security Konto anzumelden,
  bevor die Datei bereitgestellt wird.
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1 Collection" icon="download">
    Postman Collection v2.1 mit allen `/v1` Operationen und vorkonfigurierter
    Basic-Authentifizierung. Collection `baseUrl` ist leer – wählen Sie eine regionale
    Umgebung aus, bevor Sie eine Anfrage senden.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Collection herunterladen</a>
  </Card>

  <Card title="Produktionsumgebung (US)" icon="download">
    `baseUrl` voreingestellt auf `https://api.us-east-1.livingsecurity.ai/v1`, mit
    leeren Variablen `apiKeySecret` und `contractVersion`, die Sie ausfüllen müssen.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">US-Produktionsumgebung herunterladen</a>
  </Card>

  <Card title="Produktionsumgebung (EU)" icon="download">
    `baseUrl` voreingestellt auf `https://api.eu-west-1.livingsecurity.ai/v1`, mit
    leeren Variablen `apiKeySecret` und `contractVersion`, die Sie ausfüllen müssen.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">EU-Produktionsumgebung herunterladen</a>
  </Card>

  <Card title="Umgebungsvorlage" icon="download">
    Dieselben Variablen mit leerem `baseUrl`, für Nicht-Produktionsumgebungen.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Umgebungsvorlage herunterladen</a>
  </Card>
</CardGroup>

## Einrichtung in Postman

<Steps>
  <Step title="Dateien importieren">
    Wählen Sie in Postman **Import** und ziehen Sie die Collection-Datei sowie
    die Umgebung Production (US) oder Production (EU) hinein, die zur
    Organisation passt. Siehe [Regionen](/de/developers/v1/regions).
  </Step>

  <Step title="API-Schlüssel erstellen">
    Öffnen Sie im Dashboard **Einstellungen → Integrationen & Developers →
    Developer Hub**, erstellen Sie ein Servicekonto und anschließend einen API-Schlüssel. Das Schlüsselgeheimnis beginnt mit `lsk_live_` und
    wird nur einmal angezeigt – kopieren Sie es sofort. Weitere Informationen finden Sie unter
    [API-Schlüssel](/de/developers/developer-hub/api-keys).
  </Step>

  <Step title="Geheimnis einfügen">
    Legen Sie die Variable `apiKeySecret` fest – entweder in der importierten Umgebung
    (empfohlen; es handelt sich um eine Variable vom Typ „secret“) oder auf der Registerkarte
    **Variables** der Collection.
  </Step>

  <Step title="Anfrage senden">
    Wählen Sie die importierte regionale Umgebung aus, öffnen Sie eine beliebige Anfrage – zum Beispiel
    **Organization → Retrieve the organization** – und klicken Sie auf **Senden**. Senden Sie
    erst, wenn eine Umgebung ausgewählt ist; die Collection-Variable `baseUrl` ist absichtlich
    leer.
  </Step>
</Steps>

## So ist die Authentifizierung vorkonfiguriert

Die Collection legt Basic-Authentifizierung auf Collection-Ebene fest, mit dem Benutzernamen `apikey`
und dem Passwort `{{apiKeySecret}}`. Die API akzeptiert das Schlüsselgeheimnis in beiden
Basic-Auth-Feldern, sodass dies ohne Änderung funktioniert, sobald die Variable gesetzt ist.

Wenn Sie die Bearer-Authentifizierung bevorzugen, ändern Sie den Typ unter **Authorization**
der Collection in **Bearer Token** und verwenden Sie `{{apiKeySecret}}` als Token – die API
akzeptiert dasselbe Geheimnis auf beide Arten.

Die Verwendung eines Bearer-Headers mit einem API-Schlüssel erfordert kein OAuth. Um OAuth zu verwenden,
setzen Sie **Bearer Token** auf Ihr OAuth-Zugriffstoken anstelle des Geheimnisses des API-Schlüssels.
Unter [Authentifizierung](/de/developers/v1/authentication) erfahren Sie, wie Sie eine Methode auswählen, und unter
[OAuth-Client-Credentials](/de/developers/v1/oauth) finden Sie die Einrichtung von Token und Client.

## Header für die Vertragsversion

Jede Anfrage enthält einen Header `Living-Security-Version`, der auf
`{{contractVersion}}` voreingestellt und standardmäßig deaktiviert ist. Lassen Sie ihn deaktiviert, um die
festgelegte Vertragsversion Ihrer Organisation zu verwenden. Aktivieren Sie ihn, um die Anfrage auf eine
bestimmte veröffentlichte Version festzulegen – die veröffentlichten Versionen finden Sie im [Changelog](/de/developers/v1/changelog).

## Abfrageparameter und Request-Bodys

Filter für List-Endpunkte (`limit`, `page_token` und ressourcenspezifische Filter)
sind in jeder Anfrage enthalten, aber deaktiviert, sodass ein frischer Import jeden
Endpunkt erfolgreich aufruft. Aktivieren und füllen Sie diejenigen aus, die Sie benötigen – unter
[Paginierung](/de/developers/v1/pagination) erfahren Sie, wie `page_token` funktioniert. Request-Bodys
bei `POST`-Operationen sind mit typisierten Platzhalterwerten vorausgefüllt.

<Note>
  Die Collection wird bei jeder Vertragsänderung aus der veröffentlichten OpenAPI-Spezifikation neu generiert –
  laden Sie eine aktuelle Kopie herunter, anstatt Anfragen zu bearbeiten, die
  aktuell bleiben sollen.
</Note>


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