Lấy theo danh định nhóm
Lấy danh sách các khối nội dung thuộc một nhóm (Group) thông qua Group Identifier.
GET /site/pageblocks/groupidentifier/:group_identifier
| Key | Value | Bắt buộc | Mô tả |
|---|
SiteTenantId | {tenant_id} | Có | ID của công ty/tenant. |
SiteAuthorization | {jwt_token} | Không | Token khách hàng (nếu có). |
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|
group_identifier | string | Có | Định danh của nhóm khối (ví dụ: homepage-layout). |
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|
page | integer | Không | Số trang (mặc định: 1). |
limit | integer | Không | Số lượng mỗi trang (mặc định và tối đa: 50). |
sort_by | string | Không | Trường sắp xếp (display_order, id, name, date_created). Mặc định: display_order. |
sort_type | string | Không | Kiểu sắp xếp (ASC, DESC). Mặc định: ASC. |
- Hệ thống tìm nhóm khối (Page Block Group) của shop dựa trên
group_identifier.
- Lấy các
PageBlock có group_id tương ứng với ID của nhóm đó (có phân trang).
- Nếu không tìm thấy nhóm, API trả về danh sách rỗng (
total = 0) thay vì lỗi 404.
{
"total": 5,
"currentpage": 1,
"limit": 10,
"items": [
{
"id": 1001,
"identifier": "block-1"
}
]
}
Xem Page Block Object Schema
| HTTP | Mã lỗi | Mô tả |
|---|
| 404 | error_company_not_found_from_site_tenant_id | SiteTenantId không hợp lệ hoặc shop không còn hoạt động. |