> ## 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 Collection 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="Окружение Production (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="Окружение Production (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 выберите **Импорт** и добавьте файл коллекции, а также окружение
    Production (US) или Production (EU), соответствующее
    организации. См. [Регионы](/ru/developers/v1/regions).
  </Step>

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

  <Step title="Вставьте секрет">
    Задайте переменную `apiKeySecret` — либо в импортированном окружении
    (рекомендуется; это переменная типа secret), либо на вкладке
    **Переменные** коллекции.
  </Step>

  <Step title="Отправьте запрос">
    Выберите импортированное региональное окружение, откройте любой запрос — например,
    **Организация → Retrieve the organization** — и нажмите **Отправить**. Не
    отправляйте запросы, пока не выбрано окружение: значение `baseUrl` в коллекции намеренно
    пустое.
  </Step>
</Steps>

## Как предварительно настроена аутентификация

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

Если вы предпочитаете аутентификацию типа Bearer, измените тип **Authorization**
коллекции на **Bearer Token** и используйте в качестве токена `{{apiKeySecret}}` — API
принимает один и тот же секрет в обоих случаях.

Использование заголовка Bearer с ключом API не требует OAuth. Чтобы использовать OAuth,
укажите в поле **Bearer Token** ваш токен доступа OAuth вместо секрета ключа API.
Сведения о выборе метода см. в разделе [Аутентификация](/ru/developers/v1/authentication), а о настройке токенов и клиентов —
в разделе [Учетные данные клиента OAuth](/ru/developers/v1/oauth).

## Заголовок версии контракта

Каждый запрос содержит заголовок `Living-Security-Version` со значением
`{{contractVersion}}`, по умолчанию отключенный. Оставьте его отключенным, чтобы использовать
закрепленную версию контракта вашей организации. Включите его, чтобы закрепить запрос за
определенной опубликованной версией — список опубликованных версий см. в [журнале изменений](/ru/developers/v1/changelog).

## Параметры запроса и тела запросов

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

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


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