Truy xuất các tài liệu đã xuất bản cho một lược đồ — tất cả, một, một lô hoặc một trang — dưới dạng mảng JSON được truyền luồng.
Truy xuất các tài liệu đã xuất bản cho một lược đồ — tất cả, một tài liệu đơn lẻ, một lô theo ID, hoặc một trang — được truyền dưới dạng một mảng JSON. Cũng khả dụng tại /schemas/{schema_name}. Tham chiếu hình ảnh được phân giải thành URL, và khi language được thiết lập thì bản dịch tương ứng sẽ được gộp lên nội dung gốc.
Xác thực: Khóa API. Chỉ cần có khóa khi máy chủ đặt require_schema_api_key = true; nếu không thì cho phép đọc ẩn danh.
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
schema_name | string | có | Lược đồ tài liệu, ví dụ: post. |
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
websiteId | uuid | không | Trang web đích; quay về tiêu đề Host / cấu hình khi không cung cấp. |
id | uuid | không | Truy xuất một tài liệu đơn lẻ. Ưu tiên hơn ids. |
ids | string | không | Các UUID phân tách bằng dấu phẩy (lô, tối đa 200). Ưu tiên hơn phân trang. |
language | string | không | Gộp bản dịch cho ngôn ngữ này lên nội dung gốc. |
limit | integer | không | Kích thước trang, mặc định 200, giới hạn tối đa 200. |
offset | integer | không | Số hàng cần bỏ qua (chỉ áp dụng khi giới hạn lớn hơn 0). |
api_key | string | không | Lựa chọn thay thế cho tiêu đề x-api-key. |
Khi cả id và ids đều không được thiết lập, các tài liệu sẽ được trả về theo thứ tự published_at DESC.
Một mảng JSON được truyền luồng. Mỗi phần tử là nội dung đã xuất bản của tài liệu ở cấp cao nhất, cùng với các khóa được chèn _id, _title và _publishedAt:
[
{
"_id": "...",
"_title": "Bắt đầu",
"_publishedAt": "2026-06-23T20:36:31Z",
"title": "Bắt đầu",
"description": "...",
"content": "..."
}
]
Các trường nội dung sẽ ghi đè lên những khóa được chèn khi trùng lặp. Tham chiếu hình ảnh có dạng { alt, _asset: { id } } sẽ được bổ sung url đã phân giải vào _asset.
curl '{CMS_API_URL}/dataset/post?websiteId=<uuid>&limit=50' \
-H 'x-api-key: <key>'
400 — websiteId không hợp lệ, id không hợp lệ, hoặc ids sai (trống, nhiều hơn 200, hoặc một UUID không hợp lệ)401 — khóa API không hợp lệ (hoặc thiếu khi được yêu cầu)500 — truy vấn thất bại