Chi tiết thương hiệu (Slug/ID)

Endpoint

GET /site/brands/slug/{slug}

Headers

Workflow & Logic

API này phục vụ cho việc Routing (Định tuyến) URL thương hiệu sản phẩm trên Storefront.

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.
   • Nếu slug là chuỗi: Hệ thống hiểu là tìm theo SEO URL (seo_url).

2. Tìm kiếm (Lookup):

   • Theo ID: Tạo Brand object trực tiếp từ ID.
   • Theo SEO URL: Tìm trong Database (bảng meta_brand) với seourl = slug và status = 1 (Kích hoạt).

3. Kiểm tra (Validation):

   • Thương hiệu phải thuộc đúng company (tenant).
   • Thương hiệu phải ở trạng thái Kích hoạt (status = 1).

4. Kết quả:

   • Nếu hợp lệ: Trả về đối tượng thương hiệu.
   • Nếu không tìm thấy: Trả về lỗi 404 (Not Found).

Parameters

Response Schema

HTTP 200 - JSON Object

{
    "company_id": 1,
    "creator_id": 10,
    "id": 50,
    "name": "Nike",
    "description": "<p>Thương hiệu thể thao hàng đầu thế giới</p>",
    "display_order": 1.0,
    "avatar_file_id_list": [201],
    "avatar_file_list": [
        {
            "id": 201,
            "url": "https://example.com/nike-logo.jpg"
        }
    ],
    "gallery_file_id_list": [],
    "gallery_file_list": [],
    "status": 1,
    "seo_url": "nike",
    "seo_title": "Nike - Thương hiệu thể thao",
    "seo_meta_description": "Sản phẩm chính hãng Nike",
    "seo_meta_keyword": "nike, thể thao",
    "seo_graph_file_id": 0,
    "seo_graph_file": {},
    "seo_canonical": "",
    "seo_options": {},
    "date_created": 1710000000,
    "date_modified": 1710000000
}

Xem Brand Object Schema

HTTP 404

Nếu không tìm thấy thương hiệu hoặc thương hiệu không ở trạng thái kích hoạt.