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

KeyValueBắt buộcMô 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)

  1. Phân giải tham số (Parameter Resolution):

    • Kiểm tra slug đầu vào.
    • Nếu slug là 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 slug là chuỗi: Hệ thống hiểu là tìm theo SEO URL.
  2. Tìm kiếm & Cache (Lookup & Caching):

    • Search: Tìm danh mục của shop hiện tại có seo_url = slug và 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 tra status nếu cần.
  3. 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ênKiểuBắt buộcMô tả
slugstring hoặc integerCó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"]}.

On this page