Quản lý sản phẩm (PIM)Sản phẩm

Chi tiết theo Slug

Lấy thông tin chi tiết sản phẩm theo Slug (SEO Friendly URL).

Endpoint

GET /site/products/slug/{slug}

Headers

KeyValueBắt buộcMô tả
SiteTenantId{tenant_id}CóID của công ty/tenant.

Parameters

TênKiểuBắt buộcMô tả
slugstringCóSlug (URL) hoặc ID của sản phẩm.

Workflow & Logic

  1. Nếu slug là số: tìm sản phẩm theo ID; ngược lại tìm theo SEO URL (seo_url) trong shop hiện tại.
  2. Sản phẩm chỉ được trả về khi thuộc shop hiện tại và có chế độ hiển thị (visibility) là Hiển thị, Chỉ danh mục hoặc Chỉ tìm kiếm. Sản phẩm đính kèm (quà tặng/phụ kiện) hoặc bị ẩn trả về 404.
  3. Giá của các biến thể được tính theo chính sách giá cấu hình cho website (website_price_policy_id).

Response Schema

HTTP 200 - JSON Object

Trả về đối tượng Product đầy đủ thông tin, bao gồm cả các trường Listing và Detail-only (description, summary, attribute_detail, group, SEO fields...).

{
  "id": 10,
  "name": "Iphone 15 Pro Max",
  "seo_url": "iphone-15-pro-max",
  "description": "<p>Chi tiết sản phẩm</p>",
  "summary": "Tóm tắt sản phẩm",
  "attribute_detail": [
    { "name": "Màn hình", "value": "6.7 inch" }
  ],
  "group": [
    { "product_id": 11, "name": "Iphone 15 Pro", "seo_url": "iphone-15-pro" }
  ]
  // ... Tất cả các trường của Product Object
}

Xem Product Object Schema · Variant Object Schema

HTTP 404

Nếu không tìm thấy sản phẩm hoặc slug không hợp lệ. Response: {"error": ["error_not_found"]}.

On this page