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
| Key | Value | Bắt buộc | Mô 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)
-
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.
- Khởi tạo site context từ header
-
Lọc dữ liệu (Filtering):
-
Chỉ lấy các phản hồi có:
status = STATUS_VERIFIED(đã được duyệt).product_comment_idkhớp với bình luận được yêu cầu.
-
-
Sắp xếp & Phân trang (Sorting & Pagination):
- Sắp xếp theo trường được chỉ định (
sort_by), mặc định theoidtăng dần (ASC). - Phân trang với
pagevàlimit, mặc địnhpage = 1vàlimit = 50(tối đa 50).
- Sắp xếp theo trường được chỉ định (
-
Đế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).
-
Format & Trả về (Formatting & Response):
- Lấy danh sách
ProductCommentReplytheo đ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[].
- Lấy danh sách
Parameters
| Tên | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
comment_id | integer | Có | ID bình luận sản phẩm (trong URL path). |
page | integer | Trang hiện tại (Mặc định: 1). | |
limit | integer | Số lượng bản ghi mỗi trang (Mặc định và tối đa: 50). | |
sort_by | string | Trường sắp xếp (id, status, date_created). Mặc định: id. | |
sort_type | string | Hướ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
| HTTP | Mã lỗi | Mô tả |
|---|---|---|
| 422 | error_not_permission | Bình luận không tồn tại, chưa được duyệt hoặc không thuộc về shop. |
| 404 | error_company_not_found_from_site_tenant_id | SiteTenantId không hợp lệ hoặc shop không còn hoạt động. |