CMSKhối nội dung

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.

Endpoint

GET /site/pageblocks/groupidentifier/:group_identifier

Headers

KeyValueBắt buộcMô tả
SiteTenantId{tenant_id}CóID của công ty/tenant.
SiteAuthorization{jwt_token}KhôngToken khách hàng (nếu có).

Parameters

TênKiểuBắt buộcMô tả
group_identifierstringCóĐịnh danh của nhóm khối (ví dụ: homepage-layout).

Query Parameters

TênKiểuBắt buộcMô tả
pageintegerKhôngSố trang (mặc định: 1).
limitintegerKhôngSố lượng mỗi trang (mặc định và tối đa: 50).
sort_bystringKhôngTrường sắp xếp (display_order, id, name, date_created). Mặc định: display_order.
sort_typestringKhôngKiểu sắp xếp (ASC, DESC). Mặc định: ASC.

Workflow & Logic

  1. Hệ thống tìm nhóm khối (Page Block Group) của shop dựa trên group_identifier.
  2. Lấy các PageBlock có group_id tương ứng với ID của nhóm đó (có phân trang).
  3. 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.

Response Schema

HTTP 200 - JSON Array

{
  "total": 5,
  "currentpage": 1,
  "limit": 10,
  "items": [
    {
      "id": 1001,
      "identifier": "block-1"
    }
  ]
}

Xem Page Block Object Schema

Error Codes

HTTPMã lỗiMô tả
404error_company_not_found_from_site_tenant_idSiteTenantId không hợp lệ hoặc shop không còn hoạt động.

On this page