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

> Importeer de gegenereerde Postman-collectie van de Living Security Public API, plak een API-sleutel en roep /v1 binnen enkele minuten aan.

De Postman-collectie voor de Living Security API v1 wordt gegenereerd op basis van dezelfde
OpenAPI-specificatie waarop de [API v1-referentie](/v1-reference/openapi-v1.json) is gebaseerd,
zodat deze altijd overeenkomt met het gepubliceerde contract. De collectie omvat alle `/v1`-bewerkingen,
gegroepeerd per resource, met vooraf geconfigureerde authenticatie.

## Downloaden

<Info>
  Bij de downloadlinks wordt u gevraagd u aan te melden met uw Living Security-account
  voordat het bestand wordt aangeboden.
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1-collectie" icon="download">
    Postman Collection v2.1 met alle `/v1` bewerkingen en vooraf geconfigureerde
    Basic-authenticatie. Collectie `baseUrl` is leeg: selecteer een regionale
    omgeving voordat u een verzoek verzendt.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Download de collectie</a>
  </Card>

  <Card title="Productieomgeving (VS)" icon="download">
    `baseUrl` vooraf ingesteld op `https://api.us-east-1.livingsecurity.ai/v1`, met
    lege variabelen `apiKeySecret` en `contractVersion` die u moet invullen.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Download de productieomgeving voor de VS</a>
  </Card>

  <Card title="Productieomgeving (EU)" icon="download">
    `baseUrl` vooraf ingesteld op `https://api.eu-west-1.livingsecurity.ai/v1`, met
    lege variabelen `apiKeySecret` en `contractVersion` die u moet invullen.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Download de productieomgeving voor de EU</a>
  </Card>

  <Card title="Omgevingssjabloon" icon="download">
    Dezelfde variabelen met een lege `baseUrl`, voor niet-productieomgevingen.

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

## Instellen in Postman

<Steps>
  <Step title="De bestanden importeren">
    Kies in Postman **Import** en sleep het collectiebestand samen met de
    omgeving Production (US) of Production (EU) die bij uw
    organisatie past naar het venster. Zie [Regio's](/nl/developers/v1/regions).
  </Step>

  <Step title="Een API-sleutel aanmaken">
    Open in het Dashboard **Instellingen → Integraties & Developers →
    Developer Hub**, maak een serviceaccount aan en maak vervolgens een API-sleutel aan. Het sleutelgeheim begint met `lsk_live_` en
    wordt slechts één keer getoond: kopieer het direct. Zie
    [API-sleutels](/nl/developers/developer-hub/api-keys) voor meer informatie.
  </Step>

  <Step title="Het geheim plakken">
    Stel de variabele `apiKeySecret` in, hetzij in de geïmporteerde omgeving
    (aanbevolen; het is een variabele van het type secret), hetzij op het tabblad
    **Variables** van de collectie.
  </Step>

  <Step title="Een verzoek verzenden">
    Selecteer de geïmporteerde regionale omgeving, open een willekeurig verzoek, bijvoorbeeld
    **Organization → Retrieve the organization**, en klik op **Send**. Verzend
    geen verzoek zolang er geen omgeving is geselecteerd; de collectie `baseUrl` is
    bewust leeg.
  </Step>
</Steps>

## Hoe authenticatie vooraf is geconfigureerd

De collectie stelt Basic-authenticatie in op collectieniveau in met gebruikersnaam `apikey`
en wachtwoord `{{apiKeySecret}}`. De API accepteert het sleutelgeheim in beide
Basic-authenticatievelden, dus dit werkt direct zodra de variabele is ingesteld.

Als u de voorkeur geeft aan bearer-authenticatie, wijzigt u het type **Authorization**
van de collectie in **Bearer Token** en gebruikt u `{{apiKeySecret}}` als token. De API
accepteert hetzelfde geheim op beide manieren.

Het gebruik van een Bearer-header met een API-sleutel vereist geen OAuth. Als u OAuth wilt gebruiken,
stelt u **Bearer Token** in op uw OAuth-toegangstoken in plaats van het geheim van de API-sleutel.
Zie [Authenticatie](/nl/developers/v1/authentication) om een methode te kiezen en
[OAuth client credentials](/nl/developers/v1/oauth) voor de configuratie van tokens en clients.

## Header voor contractversie

Elk verzoek bevat een header `Living-Security-Version` die vooraf is ingesteld op
`{{contractVersion}}` en standaard is uitgeschakeld. Laat deze uitgeschakeld om de vastgezette
contractversie van uw organisatie te gebruiken. Schakel deze in om het verzoek vast te zetten op een
specifieke gepubliceerde versie. Zie het [wijzigingslogboek](/nl/developers/v1/changelog)
voor gepubliceerde versies.

## Queryparameters en bodies

Filters voor lijsteindpunten (`limit`, `page_token` en resourcespecifieke filters)
zijn bij elk verzoek opgenomen maar uitgeschakeld, zodat een nieuw geïmporteerde collectie elk
eindpunt succesvol aanroept. Schakel de filters die u nodig hebt in en vul ze in. Zie
[Paginering](/nl/developers/v1/pagination) voor de werking van `page_token`. De request-
bodies van `POST`-bewerkingen zijn vooraf ingevuld met getypeerde plaatshouderwaarden.

<Note>
  De collectie wordt bij elke contractwijziging opnieuw gegenereerd op basis van de gepubliceerde OpenAPI-specificatie.
  Download daarom een nieuwe kopie in plaats van verzoeken te bewerken
  die u actueel wilt houden.
</Note>


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