> ## 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` 操作的 Postman Collection v2.1，並已預先設定 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**，並放入集合檔案，以及與貴組織相符的
    正式環境（US）或正式環境（EU）檔案。請參閱[區域](/zh-Hant/developers/v1/regions)。
  </Step>

  <Step title="建立 API 金鑰">
    在儀表板中，開啟 **設定 → 整合與開發人員 →
    Developer Hub**，建立服務帳戶，然後建立 API 金鑰。金鑰密碼以 `lsk_live_` 開頭，
    且僅顯示一次——請立即複製。詳情請參閱
    [API 金鑰](/zh-Hant/developers/developer-hub/api-keys)。
  </Step>

  <Step title="貼上金鑰密碼">
    設定 `apiKeySecret` 變數——可在已導入的環境中設定
    （建議使用，因為它是機密類型的變數），或在集合的
    **變數** 索引標籤中設定。
  </Step>

  <Step title="發送請求">
    選擇已導入的區域環境，開啟任一請求——例如
    **Organization → Retrieve the organization**——然後按一下 **Send**。在選擇環境之前，請勿
    發送請求；集合的 `baseUrl` 刻意保持空白。
  </Step>
</Steps>

## 驗證的預先設定方式

集合在集合層級設定 Basic 驗證，使用者名稱為 `apikey`，
密碼為 `{{apiKeySecret}}`。API 接受在任一 Basic 驗證欄位中提供金鑰密碼，
因此在設定變數後即可直接使用。

如果您偏好使用 Bearer 驗證，請將集合的 **Authorization**
類型變更為 **Bearer Token**，並使用 `{{apiKeySecret}}` 作為權杖——API
兩種方式都接受相同的金鑰密碼。

使用 API 金鑰搭配 Bearer 標頭不需要 OAuth。若要使用 OAuth，
請將 **Bearer Token** 設為您的 OAuth 存取權杖，而非 API 金鑰密碼。
如需選擇方法，請參閱[驗證](/zh-Hant/developers/v1/authentication)；
權杖與用戶端設定，請參閱 [OAuth 用戶端憑證](/zh-Hant/developers/v1/oauth)。

## 合約版本標頭

每個請求都帶有 `Living-Security-Version` 標頭，預設為
`{{contractVersion}}`，且預設為停用。保持停用即可使用貴組織
固定的合約版本。啟用後可將請求固定到
特定的已發布版本——已發布的版本請參閱[變更記錄](/zh-Hant/developers/v1/changelog)。

## 查詢參數與本文

清單端點的篩選條件（`limit`、`page_token` 以及各資源專屬的篩選條件）
已包含在每個請求中但處於停用狀態，因此全新導入後即可成功呼叫每個
端點。請啟用並填寫您需要的項目——有關 `page_token` 的運作方式，請參閱
[分頁](/zh-Hant/developers/v1/pagination)。`POST` 操作的請求
本文已預先填入具類型的預留位置值。

<Note>
  每次合約變更時，集合都會根據已發布的 OpenAPI 規格重新產生——
  請下載最新副本，而不要編輯您想保持最新的請求。
</Note>


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