Liệt kê các bản tóm tắt thành phần tùy chỉnh (schema loại nội dung) của một website.
Liệt kê các bản tóm tắt custom-component (schema loại nội dung) cho một website, được sắp xếp theo tên. Chỉ các schema tùy chỉnh do người dùng định nghĩa mới được trả về.
Xác thực: API key (x-api-key header hoặc tham số truy vấn api_key).
| Tham số | Kiểu | Bắt buộc | Ghi chú |
|---|---|---|---|
websiteId | uuid | có | Phải là một UUID hợp lệ. Không có dự phòng Host/cấu hình cho endpoint này. |
state | string | không | Lọc theo trạng thái vòng đời: draft, active hoặc archived. |
api_key | string | không | Thay thế cho header x-api-key. |
Một mảng JSON gồm các bản tóm tắt thành phần:
[
{
"id": "...",
"name": "post",
"displayName": "Post",
"description": "A documentation Post",
"category": "Custom",
"tags": [],
"fields": [],
"icon": null,
"source": "custom",
"version": 8,
"routeSlugField": "title"
}
]
source luôn là "custom". displayName sẽ sử dụng giá trị dự phòng là name, và category mặc định là "Custom" khi không được thiết lập.
curl '{CMS_API_URL}/components?websiteId=<uuid>&state=active' \
-H 'x-api-key: <key>'
400 — thiếu hoặc websiteId không hợp lệ401 — API key không hợp lệ