Quản lý nhóm sản phẩmGợi ý sản phẩm
Tạo gợi ý
Tạo mới một bản ghi gợi ý sản phẩm
Endpoint (Single)
POST /v1/productsuggestions
Quyền:
product.managecontent
Endpoint (Batch)
POST /v1/productsuggestions/addlist
Quyền:
product.managecontent
Request Body (Single)
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
company_id | int | Có | ID công ty |
creator_id | int | Có | ID người tạo |
product_id | int | Có | ID sản phẩm gốc (phải thuộc công ty của bạn) |
object_type | int | Có | Loại đối tượng gợi ý (1: Product). Hiện chỉ hỗ trợ giá trị 1 |
object_id | int | Có | ID đối tượng gợi ý (ID sản phẩm được gợi ý) |
product_suggestion_group_id | int | Không | ID nhóm gợi ý (Mặc định 0) |
display_order | float | Không | Thứ tự hiển thị (nếu không gửi hoặc bằng 0, hệ thống tự gán bằng giá trị lớn nhất + 1) |
status | int | Không | Trạng thái (1: Active, 3: Disabled. Mặc định: 1) |
Lưu ý: Gợi ý tạo qua API luôn có
mode= 1 (MODE_MANUAL).
Ví dụ JSON (Single)
{
"company_id": 1,
"creator_id": 10,
"product_id": 10,
"object_type": 1,
"object_id": 12,
"product_suggestion_group_id": 0,
"display_order": 0,
"status": 1
}Request Body (Batch)
Gửi company_id, creator_id ở cấp ngoài cùng, và mảng items chứa danh sách các gợi ý cần tạo.
{
"company_id": 1,
"creator_id": 10,
"items": [
{
"product_id": 10,
"object_type": 1,
"object_id": 12,
"product_suggestion_group_id": 0,
"display_order": 0,
"status": 1
},
{
"product_id": 10,
"object_type": 1,
"object_id": 15,
"product_suggestion_group_id": 0,
"display_order": 0,
"status": 1
}
]
}Response Schema (Single)
HTTP 201 - Created
Trả về ProductSuggestion Object vừa tạo.
Response Schema (Batch)
HTTP 200 - OK
Trả về danh sách các item đã tạo và lỗi (nếu có). API xử lý lần lượt từng item, item hợp lệ vẫn được tạo dù item khác bị lỗi; nếu không gửi items thì trả về danh sách rỗng.
Lưu ý
Mảng
error có thể không liệt kê đầy đủ lỗi của tất cả item (lỗi kiểm tra của item trước có thể bị ghi đè bởi item sau). Hãy đối chiếu mảng items trả về để biết item nào đã tạo thành công.| Trường | Kiểu | Mô tả |
|---|---|---|
total | int | Số item tạo thành công |
currentpage | int | Trang hiện tại (luôn = 1) |
limit | int | Số item |
items | array | Mảng ProductSuggestion Object đã tạo |
error | array | Mảng mã lỗi (nếu có). Lỗi lưu dữ liệu có dạng error_add(<object_id>) |
Error Codes
Lỗi dữ liệu đầu vào. Trả về mảng các mã lỗi:
| Mã lỗi | Mô tả |
|---|---|
error_product_not_found | Sản phẩm gốc không tìm thấy |
error_object_type_invalid | Loại đối tượng gợi ý không hợp lệ |
error_object_id_required | ID đối tượng gợi ý không được để trống |
error_object_id_same_as_product | Đối tượng gợi ý không được trùng với sản phẩm gốc |
error_target_product_not_found | Sản phẩm được gợi ý không tìm thấy |
error_target_product_already_existed | Gợi ý này đã tồn tại |
error_company_id_required | ID công ty không được để trống |
error_company_id_notfound | ID công ty không tìm thấy |
error_user1_id_required | ID người tạo không được để trống |
error_user_id_notfound | ID người tạo không tìm thấy |
error_role_not_available | Tài khoản không có quyền product.managecontent (HTTP 403) |