Tạo bình luận sản phẩm

EndpointCopy Anchor Link

POST /site/productcomments/{product_id}

HeadersCopy Anchor Link

Workflow & LogicCopy Anchor Link

API này cho phép người dùng (có thể không đăng nhập) tạo bình luận mới cho sản phẩm.

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

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 sản phẩm (theo product_id trên URL) có tồn tại và thuộc về shop của SiteTenantId.

2. Kiểm tra tính hợp lệ (Validation):

   • Họ tên (fullname): Bắt buộc, không được để trống.
   • Số điện thoại (phone): Bắt buộc, không được để trống.
   • Nội dung (content): Bắt buộc, không được để trống.
   • Email (email): Tùy chọn.
   • Sản phẩm (product_id trong body): Tùy chọn; nếu gửi thì phải trùng với product_id trên URL.
   • Biến thể sản phẩm (product_variant_id): Nếu có, phải tồn tại và thuộc đúng sản phẩm đang bình luận.
   • File đính kèm (file_id_list): Nếu có, phải là mảng ID file thuộc shop và do chính người bình luận tải lên (khách đã đăng nhập: file tải lên khi đang đăng nhập bằng tài khoản đó; khách vãng lai: file tải lên khi chưa đăng nhập).

3. Tạo bình luận:

   • Tạo mới ProductComment với trạng thái STATUS_WAIT_FOR_MODERATE (chờ duyệt).
   • Gán employee_reply_status = EMPLOYEE_REPLY_STATUS_WAITING (đang chờ phản hồi từ nhân viên).
   • Lưu địa chỉ IP của người dùng.
   • customer_id được lấy từ token SiteAuthorization (nếu có); giá trị customer_id gửi trong body sẽ bị bỏ qua.

4. Kết quả:

   • Nếu thành công: Trả về đối tượng ProductComment vừa tạo (HTTP 201).
   • Nếu lỗi validation: Trả về danh sách lỗi (HTTP 422).

ParametersCopy Anchor Link

Request BodyCopy Anchor Link

{
  "product_id": 10,
  "product_variant_id": 5,
  "fullname": "Nguyễn Văn A",
  "phone": "0901234567",
  "email": "khachhang@example.com",
  "content": "Sản phẩm này có chất lượng tốt không?",
  "file_id_list": [101, 102]
}

Request Body SchemaCopy Anchor Link

Response SchemaCopy Anchor Link

HTTP 201 - CreatedCopy Anchor Link

Trả về đối tượng Product Comment Object vừa tạo.

{
  "id": 1,
  "product_id": 10,
  "fullname": "Nguyễn Văn A",
  "phone": "0901234567",
  "email": "khachhang@example.com",
  "content": "Sản phẩm này có chất lượng tốt không?",
  "status": 1,
  "employee_reply_status": 1,
  "date_created": 1600000000
  // ... Xem thêm Product Comment Object Schema
}

HTTP 422 - Validation ErrorCopy Anchor Link

HTTP 422 - Permission ErrorCopy Anchor Link

Nếu sản phẩm không tồn tại hoặc không thuộc về shop (error_not_permission).

HTTP 500Copy Anchor Link