ReviewPhản hồi bình luận sản phẩm

Danh sách phản hồi bình luận sản phẩm

Lấy danh sách phản hồi đã được duyệt của một bình luận sản phẩm

Endpoint

GET /site/productcommentreplies/{comment_id}

Headers

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

Workflow & Logic

API này lấy danh sách các phản hồi đã được duyệt của một bình luận sản phẩm, phục vụ việc hiển thị phản hồi trong phần bình luận.

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

  1. Khởi tạo & Kiểm tra (Initialization & Validation):

    • Khởi tạo site context từ header SiteTenantId (không yêu cầu đăng nhập).
    • Kiểm tra bình luận có tồn tại, đã được duyệt và thuộc về shop của SiteTenantId.
  2. Lọc dữ liệu (Filtering):

    • Chỉ lấy các phản hồi có:

      • status = STATUS_VERIFIED (đã được duyệt).
      • product_comment_id khớp với bình luận được yêu cầu.
  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 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 ProductCommentReply theo điều kiện lọc, sắp xếp và phân trang.
    • Không trả số điện thoại và email của người phản hồi.
    • Tổng hợp vào cấu trúc response với total, currentpage, limit, và items[].

Parameters

TênKiểuBắt buộcMô tả
comment_idintegerCóID bình luận sản phẩm (trong URL path).
pageintegerTrang hiện tại (Mặc định: 1).
limitintegerSố lượng bản ghi mỗi trang (Mặc định và tối đa: 50).
sort_bystringTrường sắp xếp (id, status, date_created). Mặc định: id.
sort_typestringHướng sắp xếp (ASC, DESC). Mặc định: ASC.

Response Schema

HTTP 200 - JSON Object

{
  "total": 5,
  "currentpage": 1,
  "limit": 50,
  "items": [
    {
      "id": 1,
      "product_comment_id": 10,
      "fullname": "Nguyễn Văn B",
      "content": "Sản phẩm chất lượng tốt, bạn yên tâm nhé",
      "status": 3,
      "date_created": 1600000200
      // ... Xem thêm Product Comment Reply Object Schema
    }
  ]
}

Xem Product Comment Reply Object Schema

HTTP 422 - Permission Error

Nếu bình luận không tồn tại hoặc không thuộc về công ty.

Error Codes

HTTPMã lỗiMô tả
422error_not_permissionBình luận không tồn tại, chưa được duyệt hoặc không thuộc về shop.
404error_company_not_found_from_site_tenant_idSiteTenantId không hợp lệ hoặc shop không còn hoạt động.

On this page