CMSBanner
Danh sách Banner
Lấy danh sách các Banner đang hoạt động.
Endpoint
GET /site/banners
Headers
| 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ó). |
Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
id | integer | Không | Lọc theo ID Banner cụ thể. |
identifier | string | Không | Lọc theo định danh duy nhất. |
identifier_list | string | Không | Danh sách định danh (comma-separated). |
Response Schema
HTTP 200 - JSON Array
{
"total": 1,
"currentpage": 1,
"limit": 1,
"items": [
{
"id": 50,
"identifier": "home-hero-banner",
"images": [...]
}
]
}Lưu ý
API chỉ trả về các Banner đang Enable của shop, tối đa 10 Banner mỗi lần gọi (không phân trang). Nên lọc theo identifier hoặc identifier_list.
Error Codes
| 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. |