Danh sách cảm nhận khách hàng

EndpointCopy Anchor Link

GET /site/producttestimonials

HeadersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này lấy danh sách các cảm nhận khách hàng đang hoạt động, phục vụ việc hiển thị testimonial trên trang chi tiết sản phẩm hoặc trang chủ.

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

1. Khởi tạo (Initialization):

   • Khởi tạo site context từ header SiteTenantId (không yêu cầu đăng nhập).

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

   • Chỉ lấy các lời chứng thực có:

     • status = STATUS_ENABLE (đang hoạt động).

   • Nếu có cả object_type và object_id (đều > 0), chỉ lấy lời chứng thực của đối tượng đó.

   • Nếu không có cặp trên mà có product_id (tương thích ngược), chỉ lấy lời chứng thực của sản phẩm đó (tương đương object_type = 1 và object_id = product_id).

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 thứ tự hiển thị (displayorder) tăng dần (ASC).
   • 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. Format & Trả về (Formatting & Response):

   • Lấy danh sách ProductTestimonial theo điều kiện lọc, sắp xếp và phân trang.
   • 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,
      "object_type": 1,
      "object_id": 10,
      "object_name": "Sản phẩm ABC",
      "product_id": 10,
      "customer_name": "Nguyễn Văn A",
      "customer_title": "CEO",
      "title": "Sản phẩm tuyệt vời",
      "content": "Tôi rất hài lòng với sản phẩm này",
      "rating": 5,
      "status": 1,
      "display_order": 1,
      "date_created": 1600000000
      // ... Xem thêm Product Testimonial Object Schema
    }
  ]
}

Xem Product Testimonial Object Schema

Error CodesCopy Anchor Link