[email protected] 0943.051.818

API Thông tin sản phẩm

API này cho phép lấy thông tin chi tiết của một sản phẩm cụ thể, bao gồm phân loại, hình ảnh, giá cả và đánh giá.
Ví dụ minh họa: Chi tiết sản phẩm
GET https://api.socdo.vn/v1/product_detail
Các tham số:
  • product_id: ID sản phẩm (bắt buộc)
  • user_id: ID người dùng (tùy chọn, để check yêu thích)
  • is_member: Là thành viên (1) hay không (0) - để hiển thị giá CTV
Ví dụ lấy thông tin sản phẩm bằng cURL:
curl -X GET "https://api.socdo.vn/v1/product_detail?product_id=123&user_id=456&is_member=1" -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/product_detail?" . http_build_query([
    "product_id" => 123,
    "user_id" => 456,
    "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:
{
    "success": true,
    "message": "Lấy thông tin sản phẩm thành công",
    "data": {
        "id": "123",
        "ma_sanpham": "SP001",
        "tieu_de": "iPhone 15 Pro Max 256GB",
        "minh_hoa": "/uploads/minh-hoa/iphone15promax.jpg",
        "link": "iphone-15-pro-max-256gb",
        "cat": "1,2,3",
        "gia_cu": 35000000,
        "gia_moi": 30000000,
        "gia_drop": 28000000,
        "gia_ctv": 29000000,
        "noi_ban": "Hà Nội",
        "noi_bat": "Chip A17 Pro, Camera 48MP, Titanium",
        "noi_dung": "
Mô tả chi tiết sản phẩm...
",
        "mau": "Titan Tự Nhiên,Titan Xanh,Titan Trắng,Titan Đen",
        "thuong_hieu": "Apple",
        "size": "256GB,512GB,1TB",
        "kich_thuoc": "159.9 x 76.7 x 8.25 mm",
        "thongtin": "Thông tin kỹ thuật chi tiết...",
        "can_nang": "221g",
        "anh": "/uploads/hinh-anh/iphone1.jpg,/uploads/hinh-anh/iphone2.jpg",
        "sale": 1,
        "kho": 100,
        "kho_hcm": 50,
        "ban": 25,
        "box_banchay": 1,
        "box_noibat": 1,
        "box_flash": 0,
        "title": "iPhone 15 Pro Max 256GB - Chính hãng VN/A",
        "description": "iPhone 15 Pro Max với chip A17 Pro mạnh mẽ",
        "view": 1501,
        "shop": "0",
        "status": "1",
        "date_post": "1695020400",
        "total_reviews": 45,
        "avg_rating": 4.8,
        "gia_cu_formatted": "35,000,000",
        "gia_moi_formatted": "30,000,000",
        "gia_ctv_formatted": "29,000,000",
        "gia_drop_formatted": "28,000,000",
        "discount_percent": 14,
        "date_post_formatted": "18/09/2023 15:00:00",
        "images": {
            "main": "https://api.socdo.vn/uploads/minh-hoa/iphone15promax.jpg",
            "thumb": "https://api.socdo.vn/uploads/thumbs/sanpham_anh_340x340/iphone15promax.jpg",
            "gallery": [
                "https://api.socdo.vn/uploads/hinh-anh/iphone1.jpg",
                "https://api.socdo.vn/uploads/hinh-anh/iphone2.jpg"
            ]
        },
        "product_url": "https://api.socdo.vn/san-pham/123/iphone-15-pro-max-256gb.html",
        "badges": ["Bán chạy", "Nổi bật", "-14%", "Voucher", "Freeship", "Chính hãng"],
        "voucher_icon": "Voucher",
        "freeship_icon": "Freeship",
        "chinhhang_icon": "Chính hãng",
        "sold_count": 89,
        "star_html": "",
        "label_sale": "
-14%
",
        "price_thanhvien": "29,000,000₫",
        "is_favorited": true,
        "variants": [
            {
                "id": "1",
                "sp_id": "123",
                "ten_phanloai": "256GB - Titan Tự Nhiên",
                "gia_cu": 35000000,
                "gia_moi": 30000000,
                "gia_ctv": 29000000,
                "gia_drop": 28000000,
                "kho": 20,
                "gia_cu_formatted": "35,000,000",
                "gia_moi_formatted": "30,000,000",
                "gia_ctv_formatted": "29,000,000",
                "gia_drop_formatted": "28,000,000",
                "discount_percent": 14
            }
        ],
        "categories": [
            {
                "cat_id": "1",
                "cat_tieude": "Điện thoại",
                "cat_link": "dien-thoai",
                "category_url": "https://api.socdo.vn/danh-muc/1/dien-thoai.html"
            }
        ]
    }
}
Tính năng chi tiết:
  • Thông tin đầy đủ: Tất cả fields từ bảng sanpham
  • Phân loại sản phẩm: Lấy từ bảng phanloai_sanpham
  • Hình ảnh gallery: Xử lý từ trường 'anh', tạo array hình ảnh
  • Danh mục: Parse từ trường 'cat', lấy thông tin từ category_sanpham
  • Giá ưu tiên: Từ phanloai_sanpham nếu có, fallback về sanpham
  • Check yêu thích: Kiểm tra user đã yêu thích sản phẩm chưa
  • Cập nhật view: Tự động tăng lượt xem khi gọi API
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 (sp_id, ten_phanloai, gia_*)
  • product_comments: Đánh giá và rating
  • category_sanpham: Thông tin danh mục
  • yeu_thich_san_pham: Check trạng thái yêu thích
  • 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
  • product_id là tham số bắt buộc
  • API tự động cập nhật lượt xem khi được gọi
  • Trả về đầy đủ thông tin: giá, hình ảnh, phân loại, danh mục
  • Hình ảnh bao gồm: main (chính), thumb (thumbnail), gallery (bộ sưu tập)
  • Kiểm tra trạng thái yêu thích nếu có user_id
  • Giá thành viên chỉ hiển thị khi is_member=1
  • Tự động check voucher và freeship theo thời gian thực
API Mini App Documentation
Tài liệu hướng dẫn tích hợp API cho ứng dụng Mini App của Sóc Đỏ. Cung cấp các endpoint để phát triển ứng dụng di động với đầy đủ tính năng.
Base URL: https://api.socdo.vn/mini-app/v1/
Ví dụ tích hợp cơ bản 
// Khởi tạo Mini App
const miniApp = new SocdoMiniApp({
    appId: 'your-app-id',
    secretKey: 'your-secret-key',
    environment: 'production' // hoặc 'sandbox'
});

// Xác thực người dùng
const authResult = await miniApp.auth.login({
    phone: '0123456789',
    password: 'password123'
});

// Lấy danh sách sản phẩm
const products = await miniApp.products.list({
    page: 1,
    limit: 20,
    category: 'electronics'
});
Response mẫu 
{
    "success": true,
    "data": {
        "products": [
            {
                "id": 1,
                "name": "iPhone 15 Pro",
                "price": 29990000,
                "image": "https://example.com/image.jpg",
                "category": "electronics"
            }
        ],
        "pagination": {
            "page": 1,
            "limit": 20,
            "total": 100
        }
    },
    "message": "Lấy danh sách sản phẩm thành công"
}