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

# Bộ sưu tập Postman

> Nhập bộ sưu tập Postman của Living Security Public API đã được tạo tự động, dán khóa API và gọi /v1 chỉ trong vài phút.

Bộ sưu tập Postman cho Living Security API v1 được tạo từ cùng một đặc tả OpenAPI dùng để xây dựng [Tài liệu tham khảo API v1](/v1-reference/openapi-v1.json),
nên luôn khớp với hợp đồng đã được công bố. Bộ sưu tập bao gồm toàn bộ `/v1` thao tác,
được nhóm theo tài nguyên, với xác thực được cấu hình sẵn.

## Tải xuống

<Info>
  Các liên kết tải xuống sẽ yêu cầu Quý khách đăng nhập bằng tài khoản Living Security
  trước khi tệp được cung cấp.
</Info>

<CardGroup cols={1}>
  <Card title="Bộ sưu tập Living Security API v1" icon="download">
    Postman Collection v2.1 với toàn bộ `/v1` thao tác và xác thực Basic
    được cấu hình sẵn. Bộ sưu tập `baseUrl` để trống — hãy chọn một môi trường
    theo khu vực trước khi Quý khách gửi yêu cầu.

    <a href="/v1-reference/postman/living-security-api-v1.postman_collection.json" download="living-security-api-v1.postman_collection.json">Tải xuống bộ sưu tập</a>
  </Card>

  <Card title="Môi trường Production (US)" icon="download">
    `baseUrl` được đặt sẵn là `https://api.us-east-1.livingsecurity.ai/v1`, với
    các biến `apiKeySecret` và `contractVersion` để trống cần điền.

    <a href="/v1-reference/postman/living-security-production.postman_environment.json" download="living-security-production.postman_environment.json">Tải xuống môi trường production US</a>
  </Card>

  <Card title="Môi trường Production (EU)" icon="download">
    `baseUrl` được đặt sẵn là `https://api.eu-west-1.livingsecurity.ai/v1`, với
    các biến `apiKeySecret` và `contractVersion` để trống cần điền.

    <a href="/v1-reference/postman/living-security-production-eu.postman_environment.json" download="living-security-production-eu.postman_environment.json">Tải xuống môi trường production EU</a>
  </Card>

  <Card title="Mẫu môi trường" icon="download">
    Các biến tương tự với `baseUrl` để trống, dành cho các thiết lập không phải production.

    <a href="/v1-reference/postman/living-security-environment-template.postman_environment.json" download="living-security-environment-template.postman_environment.json">Tải xuống mẫu môi trường</a>
  </Card>
</CardGroup>

## Thiết lập trong Postman

<Steps>
  <Step title="Nhập các tệp">
    Trong Postman, chọn **Import** và thả vào tệp bộ sưu tập cùng với môi trường
    Production (US) hoặc Production (EU) phù hợp với tổ chức của Quý khách. Xem [Khu vực](/vi/developers/v1/regions).
  </Step>

  <Step title="Tạo khóa API">
    Trong Bảng điều khiển, mở **Cài đặt → Integrations & Developers →
    Developer Hub**, tạo một tài khoản dịch vụ, rồi tạo một khóa API. Mã bí mật của khóa bắt đầu bằng `lsk_live_` và
    chỉ hiển thị một lần — hãy sao chép ngay lập tức. Xem
    [Khóa API](/vi/developers/developer-hub/api-keys) để biết thêm chi tiết.
  </Step>

  <Step title="Dán mã bí mật">
    Đặt giá trị cho biến `apiKeySecret` — trong môi trường đã nhập
    (khuyến nghị; đây là biến loại bí mật) hoặc trong tab **Biến**
    của bộ sưu tập.
  </Step>

  <Step title="Gửi yêu cầu">
    Chọn môi trường theo khu vực đã nhập, mở một yêu cầu bất kỳ — ví dụ
    **Tổ chức → Retrieve the organization** — và nhấp **Gửi**. Không được
    gửi khi chưa chọn môi trường; biến `baseUrl` của bộ sưu tập được để trống
    có chủ đích.
  </Step>
</Steps>

## Cách xác thực được cấu hình sẵn

Bộ sưu tập thiết lập xác thực Basic ở cấp bộ sưu tập với tên người dùng `apikey`
và mật khẩu `{{apiKeySecret}}`. API chấp nhận mã bí mật của khóa ở một trong hai trường
của xác thực Basic, nên cấu hình này hoạt động ngay khi biến được đặt giá trị.

Nếu Quý khách muốn dùng xác thực bearer, hãy đổi loại **Authorization** của bộ sưu tập
thành **Bearer Token** và dùng `{{apiKeySecret}}` làm token — API
chấp nhận cùng một mã bí mật theo cả hai cách.

Việc dùng tiêu đề Bearer với khóa API không yêu cầu OAuth. Để dùng OAuth,
hãy đặt **Bearer Token** là access token OAuth của Quý khách thay vì mã bí mật của khóa API.
Xem [Xác thực](/vi/developers/v1/authentication) để chọn phương thức và
[Thông tin xác thực máy khách OAuth](/vi/developers/v1/oauth) để thiết lập token và máy khách.

## Tiêu đề phiên bản hợp đồng

Mỗi yêu cầu đều có tiêu đề `Living-Security-Version` được đặt sẵn là
`{{contractVersion}}`, mặc định bị tắt. Hãy để tắt để dùng phiên bản hợp đồng
được ghim cho tổ chức của Quý khách. Hãy bật để ghim yêu cầu vào một
phiên bản cụ thể đã được công bố — xem [nhật ký thay đổi](/vi/developers/v1/changelog)
để biết các phiên bản đã công bố.

## Tham số truy vấn và nội dung yêu cầu

Các bộ lọc của endpoint danh sách (`limit`, `page_token` và các bộ lọc riêng theo tài nguyên)
được đưa vào từng yêu cầu nhưng bị tắt, nên một lần nhập mới sẽ gọi thành công mọi
endpoint. Hãy bật và điền những bộ lọc Quý khách cần — xem
[Phân trang](/vi/developers/v1/pagination) để biết cách `page_token` hoạt động. Nội dung
yêu cầu của các thao tác `POST` được điền sẵn bằng các giá trị giữ chỗ theo kiểu dữ liệu.

<Note>
  Bộ sưu tập được tạo lại từ đặc tả OpenAPI đã công bố mỗi khi hợp đồng
  thay đổi — hãy tải xuống một bản mới thay vì chỉnh sửa các yêu cầu mà Quý khách
  muốn giữ luôn cập nhật.
</Note>


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