Danh sách đánh giá sản phẩm của khách hàng

EndpointCopy Anchor Link

GET /site/productreviews

HeadersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này lấy danh sách các đánh giá sản phẩm của khách hàng đang đăng nhập, phục vụ việc hiển thị lịch sử đánh giá.

Quy trình xử lý (Internal Processing)Copy Anchor Link

1. Khởi tạo & Xác thực (Initialization & Authentication):

   • Khởi tạo site context từ header SiteTenantId.
   • Xác thực khách hàng từ JWT token trong header SiteAuthorization.
   • Chỉ lấy các đánh giá có visible = 1 (hiển thị công khai) và thuộc về khách hàng đang đăng nhập.

2. Lọc dữ liệu (Filtering):

   • Lọc theo đơn hàng: Nếu có sale_order_id, chỉ lấy đánh giá của đơn hàng đó.
   • Lọc theo chi tiết đơn hàng: Nếu có sale_order_detail_id, chỉ lấy đánh giá của chi tiết đơn hàng đó.
   • Lọc theo danh sách đơn hàng: Nếu có sale_order_id_list, chỉ lấy đánh giá của các đơn hàng trong danh sách.

3. Sắp xếp & Phân trang (Sorting & Pagination):

   • Sắp xếp theo trường được chỉ định (sort_by), mặc định theo id giảm dần (DESC).
   • Phân trang với page và limit, mặc định page = 1 và limit = 50 (tối đa 50).

4. Đếm tổng số bản ghi (Counting):

   • Đếm tổng số bản ghi phù hợp với điều kiện lọc (không áp dụng limit).

5. Làm giàu dữ liệu (Data Enrichment):

   • Lấy danh sách ProductReview theo điều kiện lọc, sắp xếp và phân trang.
   • Với mỗi review, xóa các trường nhạy cảm (internal_note, moderator_id).

6. Format & Trả về (Formatting & Response):

   • Tổng hợp vào cấu trúc response với total, currentpage, limit, và items[].

ParametersCopy Anchor Link

Response SchemaCopy Anchor Link

HTTP 200 - JSON ObjectCopy Anchor Link

{
  "total": 10,
  "currentpage": 1,
  "limit": 50,
  "items": [
    {
      "id": 1,
      "product_id": 10,
      "rating": 5,
      "comment": "Sản phẩm chất lượng tốt",
      "status": 3,
      "date_created": 1600000000
      // ... Xem thêm Product Review Object Schema
    }
  ]
}

Xem Product Review Object Schema

HTTP 401 - UnauthorizedCopy Anchor Link

Nếu token không hợp lệ hoặc đã hết hạn.

Error CodesCopy Anchor Link