API Gợi ý sản phẩm

API này cung cấp nhiều loại gợi ý sản phẩm thông minh dựa trên logic hệ thống hiện tại, bao gồm voucher, freeship và giá thành viên.
Ví dụ minh họa: Gợi ý sản phẩm

GET https://api.socdo.vn/v1/product_suggest

Các tham số:

type: Loại gợi ý (mặc định: home_suggest)
- home_suggest - Gợi ý trang chủ (sản phẩm 3 tháng gần đây, có kho)
- related - Sản phẩm liên quan (cần product_id)
- bestseller - Sản phẩm bán chạy
- featured - Sản phẩm nổi bật
- flash_sale - Sản phẩm flash sale
- newest - Sản phẩm mới nhất
- random - Sản phẩm ngẫu nhiên
product_id: ID sản phẩm gốc (cho type=related)
category_id: Lọc theo danh mục (tùy chọn)
user_id: ID người dùng
limit: Số sản phẩm trả về (mặc định: 40, tối đa: 100)
exclude_ids: Loại trừ các ID sản phẩm (cách nhau bởi dấu phẩy)
is_member: Là thành viên (1) hay không (0) - để hiển thị giá CTV

Các loại gợi ý chi tiết:

1. Gợi ý trang chủ (home_suggest)

Sản phẩm đăng trong 3 tháng gần đây, có kho, kết hợp với reviews và ratings từ product_comments.

GET https://api.socdo.vn/v1/product_suggest?type=home_suggest&limit=40&is_member=1

2. Sản phẩm liên quan (related)

Gợi ý dựa trên sản phẩm hiện tại, ưu tiên cùng thương hiệu, danh mục và khoảng giá tương tự.

GET https://api.socdo.vn/v1/product_suggest?type=related&product_id=123&limit=8

3. Sản phẩm bán chạy (bestseller)

Sản phẩm có lượng bán cao nhất, có kho.

GET https://api.socdo.vn/v1/product_suggest?type=bestseller&category_id=1&limit=10

Ví dụ gợi ý trang chủ bằng cURL:

curl -X GET "https://api.socdo.vn/v1/product_suggest?type=home_suggest&limit=40&is_member=1" -H "Authorization: Bearer <token>"

Ví dụ gợi ý sản phẩm liên quan bằng PHP:

<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.socdo.vn/v1/product_suggest?" . http_build_query([
    "type" => "related",
    "product_id" => 123,
    "limit" => 8,
    "exclude_ids" => "124,125,126",
    "is_member" => 1
]));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    "Authorization: Bearer <token>"
]);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>

Dữ liệu trả về mẫu (home_suggest):

{
    "success": true,
    "message": "Lấy gợi ý sản phẩm thành công",
    "data": {
        "type": "home_suggest",
        "total_products": 40,
        "products": [
            {
                "id": "456",
                "ma_sanpham": "SP002",
                "tieu_de": "iPhone 15 Pro",
                "minh_hoa": "/uploads/minh-hoa/iphone15pro.jpg",
                "gia_cu": 30000000,
                "gia_moi": 25000000,
                "gia_ctv": 24000000,
                "thuong_hieu": "Apple",
                "kho": 80,
                "ban": 45,
                "view": 2500,
                "box_banchay": 1,
                "box_noibat": 1,
                "date_post": "1695020400",
                "link": "iphone-15-pro",
                "noi_bat": "Chip A17 Pro, Camera 48MP Pro",
                "shop": "123",
                "pl": "789",
                "total_reviews": 45,
                "avg_rating": 4.8,
                "gia_cu_formatted": "30,000,000",
                "gia_moi_formatted": "25,000,000",
                "gia_ctv_formatted": "24,000,000",
                "discount_percent": 17,
                "date_post_formatted": "18/09/2023 15:00:00",
                "image_url": "https://api.socdo.vn/uploads/thumbs/sanpham_anh_340x340/iphone15pro.jpg",
                "product_url": "https://api.socdo.vn/san-pham/456/iphone-15-pro.html",
                "badges": ["Bán chạy", "Nổi bật", "-17%", "Voucher", "Freeship", "Chính hãng"],
                "voucher_icon": "Voucher",
                "freeship_icon": "Freeship",
                "chinhhang_icon": "Chính hãng",
                "sold_count": 89,
                "star_html": "",
                "price_thanhvien": "24,000,000₫"
            }
        ],
        "parameters": {
            "product_id": 0,
            "category_id": 0,
            "user_id": 0,
            "limit": 40,
            "exclude_ids": "",
            "is_member": 1
        }
    }
}

Logic gợi ý theo hàm list_home_goiy:

Home suggest: Sản phẩm đăng trong 3 tháng gần đây, có kho > 0, JOIN với phanloai_sanpham và product_comments
Giá thành viên: Hiển thị khi is_member=1, lấy từ bảng phanloai_sanpham hoặc sanpham
Voucher/Freeship: Tự động check từ bảng coupon và transport
Hình ảnh: Ưu tiên thumbnail 340x340, fallback về ảnh gốc
Rating: Lấy từ product_comments hoặc fake data
Badges: Bao gồm Bán chạy, Nổi bật, Flash sale, Voucher, Freeship, Chính hãng

Các bảng database liên quan:

sanpham: Thông tin sản phẩm chính
phanloai_sanpham: Phân loại và giá chi tiết
product_comments: Đánh giá và rating
coupon: Voucher giảm giá
transport: Chính sách vận chuyển

Lưu ý:

Bạn cần lấy token xác thực trước khi gọi API này
Chỉ trả về sản phẩm có kho > 0
API tự động tính giá từ bảng phanloai_sanpham nếu có
Tự động check voucher và freeship theo thời gian thực
Hình ảnh ưu tiên thumbnail để tối ưu tốc độ tải
Rating và reviews được lấy từ bảng product_comments
Giá thành viên chỉ hiển thị khi is_member=1