API Tìm kiếm sản phẩm

API này cho phép tìm kiếm sản phẩm theo từ khóa, danh mục, khoảng giá và sắp xếp kết quả.
Ví dụ minh họa: Tìm kiếm sản phẩm
GET https://api.socdo.vn/v1/search_products
Các tham số:
  • keyword: Từ khóa tìm kiếm (BẮT BUỘC) - tìm trong tên sản phẩm và mã sản phẩm
  • page: Trang hiện tại (tùy chọn, mặc định: 1)
  • limit: Số sản phẩm mỗi trang (tùy chọn, mặc định: 20, tối đa: 100)
Ví dụ kết nối bằng cURL:
curl -X GET "https://api.socdo.vn/v1/search_products?keyword=điện thoại&page=1&limit=10" -H "Authorization: Bearer <token>"
Ví dụ kết nối bằng PHP:
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.socdo.vn/v1/search_products?" . http_build_query([
    "keyword" => "điện thoại",
    "page" => 1,
    "limit" => 10
]));
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:
{
    "success": true,
    "message": "Lấy danh sách sản phẩm thành công",
    "data": {
        "products": [
            {
                "id": "123",
                "ma_sanpham": "SP001",
                "tieu_de": "Điện thoại iPhone 15 Pro Max",
                "minh_hoa": "/uploads/hinh-anh/iphone15.jpg",
                "link": "dien-thoai-iphone-15-pro-max",
                "gia_cu": 35000000,
                "gia_moi": 30000000,
                "gia_drop": 28000000,
                "gia_ctv": 29000000,
                "thuong_hieu": "Apple",
                "kho": 100,
                "kho_hcm": 50,
                "ban": 25,
                "view": 1500,
                "box_banchay": 1,
                "box_noibat": 1,
                "box_flash": 0,
                "date_post": "1695020400",
                "shop": 8050,
                "province_name": "Hà Nội",
                "avg_rating": 4.8,
                "total_reviews": 45,
                "has_rating": 1,
                "gia_cu_formatted": "35,000,000",
                "gia_moi_formatted": "30,000,000",
                "gia_drop_formatted": "28,000,000",
                "gia_ctv_formatted": "29,000,000",
                "discount_percent": 14,
                "total_sold": 350,
                "sold_today": 89,
                "date_post_formatted": "18/09/2023",
                "image_url": "https://api.socdo.vn/uploads/thumbs/sanpham_anh_340x340/iphone15.jpg",
                "product_url": "https://api.socdo.vn/san-pham/123/dien-thoai-iphone-15-pro-max.html",
                "star_html": "",
                "review_count": "(45)",
                "badges": ["Bán chạy", "Nổi bật", "-14%", "Voucher", "Freeship", "Chính hãng"],
                "voucher_icon": "VoucherFreeship",
                "chinhhang_icon": "Chính hãng",
                "label_sale": "
-14%
"
            }
        ],
        "pagination": {
            "current_page": 1,
            "total_pages": 5,
            "total_products": 48,
            "limit": 10,
            "has_next": true,
            "has_prev": false
        },
        "search_params": {
            "keyword": "điện thoại",
            "page": 1,
            "limit": 10
        }
    }
}
  • Tìm kiếm đơn giản: Chỉ cần nhập từ khóa
  • Tìm trong: Tên sản phẩm (tieu_de) và mã sản phẩm (ma_sanpham)
  • Sắp xếp: Ưu tiên sản phẩm có rating cao → view cao
  • Giá từ phanloai_sanpham: MAX(gia_cu), MIN(gia_moi) nếu có
  • Hình ảnh thumbnail: /uploads/thumbs/sanpham_anh_340x340/
  • Dữ liệu bổ sung: Rating, voucher, freeship, province, sold data
  • Keyword bắt buộc: Không thể để trống từ khóa tìm kiếm
  • Chỉ sản phẩm active = 0: Sản phẩm đang hiển thị
  • Không có noi_bat, noi_dung: Giảm dung lượng response
  • Token xác thực: Cần Bearer token hợp lệ
  • Phân trang: Mặc định 20 sản phẩm/trang