> ## 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 컬렉션

> 생성된 Living Security Public API Postman 컬렉션을 가져오고, API 키를 붙여 넣은 다음, 몇 분 만에 /v1을 호출해 보십시오.

Living Security API v1 Postman 컬렉션은 [API v1 참조](/v1-reference/openapi-v1.json)를 구동하는 동일한
OpenAPI 사양에서 생성되므로 게시된 계약과 항상 일치합니다. 리소스별로 그룹화된 모든 `/v1` 작업을 포함하며,
인증이 미리 구성되어 있습니다.

## 다운로드

<Info>
  다운로드 링크를 클릭하면 파일이 제공되기 전에 Living Security 계정으로
  로그인하라는 메시지가 표시됩니다.
</Info>

<CardGroup cols={1}>
  <Card title="Living Security API v1 컬렉션" icon="download">
    모든 `/v1` 작업이 포함되어 있고 Basic 인증이 미리 구성된 Postman Collection v2.1입니다. 컬렉션 `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에서 **가져오기**를 선택하고 컬렉션 파일과 함께 해당 조직에 맞는
    프로덕션(US) 또는 프로덕션(EU) 환경을 끌어다 놓습니다. [리전](/ko/developers/v1/regions)을 참조하십시오.
  </Step>

  <Step title="API 키 생성">
    대시보드에서 **설정 → Integrations & Developers →
    Developer Hub**를 열고 서비스 계정을 만든 다음 API 키를 생성합니다. 키 시크릿은 `lsk_live_`(으)로 시작하며
    한 번만 표시되므로 즉시 복사하십시오. 자세한 내용은
    [API 키](/ko/developers/developer-hub/api-keys)를 참조하십시오.
  </Step>

  <Step title="시크릿 붙여넣기">
    `apiKeySecret` 변수를 설정합니다. 가져온 환경에서 설정하거나(권장, 시크릿 유형 변수임)
    컬렉션의 **변수** 탭에서 설정할 수 있습니다.
  </Step>

  <Step title="요청 보내기">
    가져온 리전 환경을 선택하고 아무 요청이나 엽니다. 예를 들어
    **조직 → Retrieve the organization**을 열고 **보내기**를 클릭합니다. 환경을 선택하기 전에는
    요청을 보내지 마십시오. 컬렉션 `baseUrl`은(는) 의도적으로 비어 있습니다.
  </Step>
</Steps>

## 인증이 미리 구성되는 방식

컬렉션은 컬렉션 수준에서 사용자 이름 `apikey` 및
비밀번호 `{{apiKeySecret}}`(으)로 Basic 인증을 설정합니다. API는 두 Basic 인증 필드 중 어느 쪽에서든 키 시크릿을 허용하므로,
변수를 설정하면 별도 변경 없이 그대로 작동합니다.

Bearer 인증을 사용하려면 컬렉션의 **Authorization** 유형을
**Bearer Token**으로 변경하고 `{{apiKeySecret}}`을(를) 토큰으로 사용하십시오. API는
두 방식 모두에서 동일한 시크릿을 허용합니다.

API 키와 함께 Bearer 헤더를 사용하는 데에는 OAuth가 필요하지 않습니다. OAuth를 사용하려면
**Bearer Token**을 API 키 시크릿 대신 OAuth 액세스 토큰으로 설정하십시오.
방식을 선택하려면 [인증](/ko/developers/v1/authentication)을, 토큰 및 클라이언트 설정은
[OAuth 클라이언트 자격 증명](/ko/developers/v1/oauth)을 참조하십시오.

## 계약 버전 헤더

모든 요청에는 `{{contractVersion}}`(으)로 미리 설정된 `Living-Security-Version` 헤더가 포함되며,
기본적으로 비활성화되어 있습니다. 비활성화된 상태로 두면 조직에 고정된 계약 버전이 사용됩니다. 활성화하면 요청을
게시된 특정 버전으로 고정합니다. 게시된 버전은 [변경 로그](/ko/developers/v1/changelog)를
참조하십시오.

## 쿼리 매개변수 및 본문

목록 엔드포인트 필터(`limit`, `page_token` 및 리소스별 필터)는
각 요청에 포함되어 있지만 비활성화되어 있으므로, 새로 가져온 상태에서도 모든
엔드포인트가 정상적으로 호출됩니다. 필요한 필터를 활성화하고 값을 입력하십시오. `page_token`의 작동 방식은
[페이지 매김](/ko/developers/v1/pagination)을 참조하십시오. `POST` 작업의 요청
본문에는 유형별 자리 표시자 값이 미리 채워져 있습니다.

<Note>
  컬렉션은 계약이 변경될 때마다 게시된 OpenAPI 사양에서 다시 생성됩니다. 최신 상태로 유지하려면
  요청을 직접 수정하지 말고 새 사본을 다운로드하십시오.
</Note>


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