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. - 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.
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.
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 để thực hiện yêu cầu đầu tiên,
Xác thực để biết về khóa API và OAuth, và
Khu vực để 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}).
compatibility.
Xem Tổng quan về Public API để 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ợ
để biết cách hợp đồng này phát triển.