Danh sách sản phẩm liên quan

EndpointCopy Anchor Link

GET /site/productsuggestions/{product_id}

HeadersCopy Anchor Link

Path ParametersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này dùng để lấy danh sách sản phẩm liên quan (product suggestions) đã được thiết lập cho một sản phẩm cụ thể. Kết quả chỉ trả về các bản ghi có trạng thái ENABLE (status = 1), sắp xếp theo thứ tự hiển thị (display_order ASC).

Quy trình xử lýCopy Anchor Link

1. Xác thực Session: Kiểm tra tenant từ header SiteTenantId. API này không yêu cầu đăng nhập — khách vãng lai cũng có thể gọi.

2. Kiểm tra sản phẩm gốc:

   • Tìm sản phẩm theo product_id trong path parameter.
   • Nếu sản phẩm không tồn tại hoặc không thuộc company_id hiện tại → trả lỗi 422.

3. Tự động gán bộ lọc:

   • company_id → lấy từ session.
   • product_id → lấy từ sản phẩm gốc đã xác thực.
   • status → luôn là 1 (ENABLE) — chỉ trả về các gợi ý đang kích hoạt.

4. Sắp xếp & phân trang: Mặc định sắp xếp theo display_order ASC (thứ tự hiển thị tăng dần). Hỗ trợ phân trang qua query parameters page và limit.

5. Trả kết quả: Trả về danh sách suggestion items kèm tổng số lượng và thông tin phân trang.

Query Parameters (tùy chọn)Copy Anchor Link

Response SchemaCopy Anchor Link

HTTP 200 - Thành côngCopy Anchor Link

{
  "total": 5,
  "currentpage": 1,
  "limit": 50,
  "items": [
    {
      "id": 1,
      "company_id": 123,
      "creator_id": 10,
      "product_suggestion_group_id": 5,
      "product_id": 789,
      "object_type": 1,
      "object_id": 456,
      "mode": 1,
      "mode_detail": [],
      "display_order": 1,
      "status": 1,
      "ip_address": "192.168.1.1",
      "date_created": 1740300000,
      "date_modified": 0
    }
  ]
}

Mỗi item trong mảng items là một đối tượng Product Suggestion Object.

HTTP 422 - Lỗi dữ liệuCopy Anchor Link