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

# Nhật ký thay đổi API

> Các phiên bản hợp đồng và những thay đổi đối với Living Security Public API.

Living Security Public API sử dụng các phiên bản hợp đồng dựa trên ngày
(`YYYY-MM-DD`). Tài liệu OpenAPI đã công bố nhúng phiên bản hợp đồng của mình dưới dạng
`info["x-contract-version"]`, và mỗi thao tác khai báo giai đoạn vòng đời của mình
dưới dạng `x-lifecycle-stage` (`preview`, `compatibility` hoặc `ga`).

* Đặc tả hiện hành luôn có sẵn tại
  [`/v1-reference/openapi-v1.json`](/v1-reference/openapi-v1.json).
* Các bản chụp tài liệu tham chiếu theo phiên bản có sẵn tại
  `/v1-reference/openapi/<version>.json`, ví dụ
  [`/v1-reference/openapi/2026-07-01.json`](/v1-reference/openapi/2026-07-01.json).

Các thay đổi bổ sung, tương thích ngược (thao tác mới, trường tùy chọn mới)
được phát hành trong phiên bản hợp đồng hiện hành. Phiên bản hợp đồng mới chỉ được
công bố khi có các thay đổi gây phá vỡ, kèm theo một mục trên trang này mô tả
thay đổi và lộ trình di chuyển.

## Cập nhật tài liệu

**2026-08-25** — Các hướng dẫn `/v1` và danh sách `servers` của OpenAPI hiện nêu tên các
máy chủ khu vực đang hoạt động tại Hoa Kỳ và EU. Đây là một điều chỉnh làm rõ tài liệu. Phiên bản
hợp đồng không thay đổi. Xem [Khu vực](/vi/developers/v1/regions).

## 2026-07-01

`/v1` Public API hỗ trợ phiên bản hợp đồng này. Hãy cố định phiên bản bằng
`Living-Security-Version: 2026-07-01`, hoặc sử dụng phiên bản mặc định được gán
cho tài khoản dịch vụ của quý vị.

Xem [Hướng dẫn nhanh về API](/vi/developers/v1/quickstart) để thực hiện yêu cầu đầu tiên,
[Xác thực](/vi/developers/v1/authentication) để biết về khóa API và OAuth, và
[Khu vực](/vi/developers/v1/regions) để biết máy chủ phù hợp.

## 2026-08-05

Ngày này xác định hợp đồng tương thích `/api/v1` cũ riêng biệt.
Đây không phải là giá trị `Living-Security-Version` dành cho API `/v1` mới.

* **Mọi người**: tìm kiếm những người trong tổ chức (`GET /people/search`) và truy xuất
  tư cách thành viên của một người (`GET /people/{personId}/membership`).
* **Khóa truy cập API**: tạo, liệt kê, xoay vòng và thu hồi khóa truy cập API
  (`POST /access-keys`, `GET /access-keys`, `POST /access-keys/{id}/rotate`,
  `DELETE /access-keys/{id}`).

Tất cả thao tác trong phiên bản này được công bố ở giai đoạn vòng đời `compatibility`.
Xem [Tổng quan về Public API](/vi/developers/public-api/overview) để biết về
xác thực, phân trang và xử lý lỗi, và
[chính sách tương thích và ngừng hỗ trợ](/vi/developers/public-api/overview#t%C3%ADnh-t%C6%B0%C6%A1ng-th%C3%ADch-v%C3%A0-ng%E1%BB%ABng-h%E1%BB%97-tr%E1%BB%A3)
để biết cách hợp đồng này phát triển.


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