Quản lý sản phẩm (PIM)Danh mục sản phẩm
Lấy danh sách theo IDs
Lấy thông tin nhiều danh mục cùng lúc dựa trên danh sách ID.
Endpoint
GET /site/productcategories/ids
Headers
| Key | Value | Bắt buộc | Mô tả |
|---|---|---|---|
SiteTenantId | {tenant_id} | Có | ID của công ty/tenant. |
Workflow & Logic
API này thường dùng cho các Widget hiển thị danh sách danh mục chỉ định (Featured Categories) hoặc lấy thông tin bổ sung cho một danh sách ID có sẵn.
Quy trình xử lý (Internal Processing)
-
Nhận diện danh sách ID:
- Lấy danh sách ID từ query param
ids(tối đa 100 ID, bỏ qua ID trùng hoặc không hợp lệ). - Nếu
idsrỗng: trả vềtotal = 0vàitemsrỗng.
- Lấy danh sách ID từ query param
-
Truy vấn Batch (Batch Query):
- Lấy các danh mục thuộc shop hiện tại có ID nằm trong danh sách (không lọc theo trạng thái).
- Sắp xếp kết quả theo
idASC (mặc định).
-
Trả về:
- Danh sách các đối tượng danh mục tương ứng.
Query Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
ids | string | Có | Danh sách ID phân cách bởi dấu phẩy (ví dụ: 1,2,3). |
Response Schema
HTTP 200 - JSON Object
{
"total": 2,
"items": [
{
"id": 1,
"name": "Danh mục 1",
// ...
},
{
"id": 2,
"name": "Danh mục 2",
// ...
}
]
}