Quản lý sản phẩm (PIM)Danh mục sản phẩm
Chi tiết danh mục (Slug/ID)
Lấy thông tin chi tiết danh mục dựa trên Slug hoặc ID, hỗ trợ SEO.
Endpoint
GET /site/productcategories/slug/{slug}
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 phục vụ cho việc Routing (Định tuyến) URL danh mục sản phẩm.
Quy trình xử lý (Internal Processing)
-
Phân giải tham số (Parameter Resolution):
- Kiểm tra
slugđầu vào. - Nếu
sluglà số (is_numeric): Hệ thống hiểu là tìm theo ID (chỉ trả về danh mục thuộc shop hiện tại). - Nếu
sluglà chuỗi: Hệ thống hiểu là tìm theo SEO URL.
- Kiểm tra
-
Tìm kiếm & Cache (Lookup & Caching):
- Search: Tìm danh mục của shop hiện tại có
seo_url = slugvà trạng thái khác Đã xóa (status != 5). Lưu ý: danh mục đang tắt (status = 3) vẫn được trả về, Frontend tự kiểm trastatusnếu cần.
- Search: Tìm danh mục của shop hiện tại có
-
Kết quả:
- Nếu tìm thấy và hợp lệ: Trả về đối tượng danh mục.
- Nếu không tìm thấy: Trả về lỗi 404 (Not Found) để Frontend hiển thị trang lỗi.
Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
slug | string hoặc integer | Có | Slug (SEO URL) hoặc ID của danh mục. |
Response Schema
HTTP 200 - JSON Object
{
"id": 10,
"name": "Điện thoại",
"seo_url": "dien-thoai",
"status": 1,
// ...
}Xem Product Category Object Schema
HTTP 404
Nếu không tìm thấy danh mục. Response: {"error": ["error_not_found"]}.