ReviewĐánh giá sản phẩm
Product Review Object
Cấu trúc đối tượng đánh giá sản phẩm
Schema
{
"company_id": 1,
"creator_id": 0,
"sale_order_id": 100,
"sale_order_detail_id": 50,
"product_id": 10,
"product_variant_id": 5,
"id": 1,
"customer_id": 50,
"moderator_id": 0,
"rating": 5,
"comment": "Sản phẩm chất lượng tốt",
"visible": 1,
"admin_reply": "",
"tags": "",
"waiting_duration": 0,
"file_id_list": [101, 102],
"file_list": [
{
"id": 101,
"url": "https://example.com/file.jpg"
// ... File Object
}
],
"status": 3,
"ip_address": "192.168.1.1",
"date_created": 1600000000,
"date_modified": 1600000000,
"date_moderated": 0
}Field Descriptions
| Tên trường | Kiểu dữ liệu | Mô tả |
|---|---|---|
company_id | integer | ID công ty (shop) |
creator_id | integer | ID nhân viên tạo (0 nếu khách hàng tự tạo) |
id | integer | ID đánh giá sản phẩm |
sale_order_id | integer | ID đơn hàng |
sale_order_detail_id | integer | ID chi tiết đơn hàng |
product_id | integer | ID sản phẩm được đánh giá |
product_variant_id | integer | ID biến thể sản phẩm (nếu có) |
customer_id | integer | ID khách hàng đánh giá |
rating | integer | Đánh giá (0-5 sao) |
comment | string | Bình luận (tối đa 4000 ký tự) |
visible | integer | Hiển thị công khai (1: Có, 0: Không) |
admin_reply | string | Phản hồi từ quản trị viên |
tags | string | Thẻ tag |
waiting_duration | integer | Thời gian chờ duyệt |
moderator_id | integer | ID người duyệt (chỉ có trong response tạo/sửa, bị ẩn ở API danh sách) |
ip_address | string | Địa chỉ IP khi gửi đánh giá |
file_id_list | array | Danh sách ID file đính kèm |
file_list | array | Danh sách file đính kèm (File Object) |
status | integer | Trạng thái (1: Pending, 3: Approved, 5: Rejected) |
date_created | integer | Thời gian tạo (Unix timestamp) |
date_modified | integer | Thời gian cập nhật (Unix timestamp) |
date_moderated | integer | Thời gian được duyệt (Unix timestamp) |
Status Constants
| Value | Constant | Mô tả |
|---|---|---|
1 | STATUS_PENDING | Đang chờ duyệt |
3 | STATUS_APPROVED | Đã duyệt |
5 | STATUS_REJECTED | Đã từ chối |
Auto-Approval Logic
- Nếu
commenttrống vàrating >= 4: Đánh giá được tự động duyệt (STATUS_APPROVED). - Nếu có
commenthoặcrating <= 3: Đánh giá cần được duyệt thủ công (STATUS_PENDING).