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

> Імпортуйте згенеровану колекцію Postman для Living Security Public API, вставте ключ API та викликайте /v1 за лічені хвилини.

Колекцію Postman для Living Security API v1 згенеровано з тієї самої специфікації
OpenAPI, на якій базується [довідник API v1](/v1-reference/openapi-v1.json),
тому вона завжди відповідає опублікованому контракту. Вона охоплює всі операції `/v1`,
згруповані за ресурсами, з попередньо налаштованою автентифікацією.

## Завантаження

<Info>
  Перед тим як надати файл, посилання для завантаження запропонують вам увійти
  до облікового запису Living Security.
</Info>

<CardGroup cols={1}>
  <Card title="Колекція Living Security API v1" icon="download">
    Колекція Postman v2.1 з усіма операціями `/v1` та попередньо налаштованою
    автентифікацією Basic. Колекція `baseUrl` порожня — перед надсиланням запиту
    виберіть регіональне середовище.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Завантажити колекцію</a>
  </Card>

  <Card title="Виробниче середовище (US)" icon="download">
    `baseUrl` з попередньо встановленим значенням `https://api.us-east-1.livingsecurity.ai/v1` та
    порожніми змінними `apiKeySecret` і `contractVersion`, які потрібно заповнити.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Завантажити виробниче середовище US</a>
  </Card>

  <Card title="Виробниче середовище (EU)" icon="download">
    `baseUrl` з попередньо встановленим значенням `https://api.eu-west-1.livingsecurity.ai/v1` та
    порожніми змінними `apiKeySecret` і `contractVersion`, які потрібно заповнити.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Завантажити виробниче середовище EU</a>
  </Card>

  <Card title="Шаблон середовища" icon="download">
    Ті самі змінні з порожнім `baseUrl` для невиробничих конфігурацій.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Завантажити шаблон середовища</a>
  </Card>
</CardGroup>

## Налаштування в Postman

<Steps>
  <Step title="Імпортуйте файли">
    У Postman виберіть **Import** і додайте файл колекції та середовище
    Production (US) або Production (EU), яке відповідає вашій
    організації. Див. [Регіони](/uk/developers/v1/regions).
  </Step>

  <Step title="Створіть ключ API">
    У Dashboard відкрийте **Settings → Integrations & Developers →
    Developer Hub**, створіть службовий обліковий запис і ключ API. Секрет ключа починається з `lsk_live_` і
    відображається лише один раз — скопіюйте його одразу. Докладніше див. у розділі
    [Ключі API](/uk/developers/developer-hub/api-keys).
  </Step>

  <Step title="Вставте секрет">
    Задайте змінну `apiKeySecret` — або в імпортованому середовищі
    (рекомендовано; це змінна типу secret), або на вкладці
    **Variables** колекції.
  </Step>

  <Step title="Надішліть запит">
    Виберіть імпортоване регіональне середовище, відкрийте будь-який запит, наприклад
    **Organization → Retrieve the organization**, і натисніть **Send**. Не
    надсилайте запит, доки не вибрано середовище: змінна колекції `baseUrl` порожня
    навмисно.
  </Step>
</Steps>

## Як попередньо налаштовано автентифікацію

Колекція задає автентифікацію Basic на рівні колекції з іменем користувача `apikey`
і паролем `{{apiKeySecret}}`. API приймає секрет ключа в будь-якому з полів
Basic auth, тому після встановлення змінної це працює без змін.

Якщо ви надаєте перевагу автентифікації Bearer, змініть тип **Authorization**
колекції на **Bearer Token** і використайте `{{apiKeySecret}}` як токен — API
приймає той самий секрет в обох випадках.

Використання заголовка Bearer із ключем API не потребує OAuth. Щоб використовувати OAuth,
вкажіть у полі **Bearer Token** токен доступу OAuth замість секрету ключа API.
Щоб вибрати метод, див. [Автентифікація](/uk/developers/v1/authentication), а для налаштування токена й клієнта —
[Облікові дані клієнта OAuth](/uk/developers/v1/oauth).

## Заголовок версії контракту

Кожен запит містить заголовок `Living-Security-Version` зі значенням
`{{contractVersion}}`, який за замовчуванням вимкнено. Залиште його вимкненим, щоб використовувати
закріплену версію контракту вашої організації. Увімкніть його, щоб закріпити запит за
певною опублікованою версією — опубліковані версії наведено в
[журналі змін](/uk/developers/v1/changelog).

## Параметри запиту та тіла запитів

Фільтри кінцевих точок списків (`limit`, `page_token` та фільтри, специфічні для ресурсу)
додано до кожного запиту у вимкненому стані, тож після нового імпорту кожна
кінцева точка викликається успішно. Увімкніть і заповніть потрібні вам фільтри — про роботу `page_token` див.
[Пагінація](/uk/developers/v1/pagination). Тіла
запитів для операцій `POST` попередньо заповнено типізованими значеннями-заповнювачами.

<Note>
  Колекція повторно генерується з опублікованої специфікації OpenAPI після кожної
  зміни контракту — завантажуйте свіжу копію, а не редагуйте запити, які
  потрібно підтримувати актуальними.
</Note>


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