Truy xuất các khối theo ID, theo thứ tự yêu cầu, với các tham chiếu hình ảnh đã được chuyển thành URL.
Truy xuất các khối theo ID cho một trang web, với các tham chiếu hình ảnh được chuyển thành URL. Các khối được trả về theo cùng thứ tự với ids đã yêu cầu; các ID không xác định sẽ bị bỏ qua mà không có thông báo.
Xác thực: Khóa API (header x-api-key hoặc tham số truy vấn api_key).
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
websiteId | uuid | không | Trang web đích; nếu trống sẽ dùng header Host / cấu hình. |
ids | string | không | Danh sách UUID của khối, phân tách bằng dấu phẩy. Rỗng hoặc thiếu → []. |
api_key | string | không | Phương án thay thế cho header x-api-key. |
Một mảng JSON các khối:
[
{
"id": "...",
"website_id": "...",
"schema_id": "...",
"draft_content": {},
"published_content": {},
"state": "published",
"version": 3,
"schema_name": "hero-block",
"layout": {},
"cloned_from_id": null,
"created_at": "2026-06-23T18:34:16Z",
"updated_at": "2026-06-23T20:36:55Z"
}
]
curl '{CMS_API_URL}/blocks?websiteId=<uuid>&ids=<id1>,<id2>' \
-H 'x-api-key: <key>'
400 — UUID không hợp lệ trong ids, hoặc không thể xác định trang web401 — khóa API không hợp lệ