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. - 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 trong Database (bảng
product_category) vớiseourl = slugvàstatus != DELETED. - Caching: Sử dụng Redis Cache (
productcategory_slug_{company_id}_{slug}) để giảm tải DB. Nếu tìm thấy ID từ Cache, sẽ lấy object từ Cache ID đó.
- Search: Tìm trong Database (bảng
-
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.