Tạo gợi ý

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
`object_type`	int	Có	Loại đối tượng gợi ý (1: Product)
`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ị (tự tính max + 1)
`status`	int	Không	Trạng thái (1: Active, 3: Disabled. Mặc định: 1)

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ó).

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ó)

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

Tạo gợi ý

On this page