Lấy thông tin chi tiết của một sản phẩm

API này giúp bạn lấy thông tin chi tiết của một sản phẩm dựa trên product-id được cung cấp trong URL. Bạn cần thay thế {product-id} trong URL bằng ID thực tế của sản phẩm mà bạn muốn lấy thông tin. Sử dụng tham số select để lấy thêm dữ liệu biến thể (variants) và SKU (skus) mới nhất từ hệ thống.

---

Endpoint

🔗Endpoint Staging

GET https://staging-manage.api.miniai.vn/api/external/v1/products/{product-id}

Example

https://staging-manage.api.miniai.vn/api/external/v1/products/68c92090e51492ac6339a955

🔗Endpoint Production

GET https://manage-api.miniap.vn/api/external/v1/products/{product-id}

Xác thực (Authentication)

Mọi request phải gửi kèm API key của bạn trong header:

Header	Giá trị	Yêu cầu
x-api-key	miniai-partner <API_KEY_CỦA_BẠN>	Bắt buộc

Tham số truy vấn (Query Parameters)

Tham số	Kiểu	Yêu cầu	Mặc định	Mô tả
select	string	Tùy chọn	—	Danh sách trường cần lấy thêm, phân tách bằng dấu phẩy (xem bên dưới)

Giá trị của select

Truyền nhiều giá trị bằng cách phân tách bằng dấu phẩy, ví dụ select=skus,variants.

Giá trị	Mô tả
skus	Trả về danh sách SKU mới nhất (kèm _id của từng SKU)
variants	Trả về danh sách biến thể mới nhất trong trường itemVariants (kèm _id và các tùy chọn)

⚠️skuDrafts và dữ liệu biến thể mới nhất

Mặc định sản phẩm có sẵn trường skuDrafts chứa biến thể/SKU được lưu lại tại thời điểm tạo hoặc import sản phẩm.

Để lấy dữ liệu biến thể và SKU mới nhất, chính xác (kèm ID hiện hành), hãy dùng select=skus,variants. Khi đó:

• skus chứa các SKU hiện hành, mỗi phần tử có _id (ID SKU) và variantOptionIDs.
• itemVariants chứa các nhóm biến thể hiện hành, mỗi tùy chọn có _id (ID tùy chọn biến thể).

Lưu ý:

• Dù bạn truyền select=variants, dữ liệu trả về nằm ở trường tên là itemVariants (không phải variants).
• Khác với API lấy danh sách, API chi tiết trả về tất cả SKU khi dùng select=skus, bao gồm cả SKU không hoạt động (isActive: false).

Example — lấy kèm biến thể và SKU

https://staging-manage.api.miniai.vn/api/external/v1/products/68c92090e51492ac6339a955?select=skus,variants

Phản hồi (Response)

Mặc định (có skuDrafts)

{
    "success": true,
    "data": {
        "subItemsGroupIds": [],
        "configs": [],
        "hashtags": [],
        "collectionIDs": [],
        "totalRating": 0,
        "totalReview": 0,
        "sortOrder": 0,
        "isNullSortOrder": false,
        "brandProductIds": [],
        "fakeReviewIds": [],
        "_id": "68c92090e51492ac6339a955",
        "type": "product",
        "sProductId": "1069978281",
        "platform": "haravan",
        "name": "Áo có slogan",
        "description": "<ul><li>Chất vải: Thun Cotton, Co giãn 4 chiều, Dày, Mịn, Đẹp</li><li>Form áo rộng nên thích hợp cho cả Nam và Nữ</li><li>Áo thiết kế cổ tròn, tay ngắn, đường may tinh tế</li><li>Kích thước hình in lớn, không giới hạn màu sắc</li><li>Cắt may và in ấn trực tiếp tại xưởng không qua trung gian</li><li>Chất liệu thun mềm mại co giãn tốt, thoáng mát.</li><li>Thiết kế thời trang phù hợp xu hướng hiện nay.</li><li>Áo được thiết kế đẹp, chuẩn form, đường may sắc xảo, vải cotton dày, mịn, thấm hút mồ hôi tạo sự thoải mái khi mặc.</li><li>Quá trình sản xuất ít sử dụng hóa chất, thân thiện với môi trường.</li><li>Dễ dàng phối trang phục , thích hợp đi chơi đi làm đi dạo phố.</li></ul>",
        "images": [
            "https://cdn.hstatic.net/products/200001061016/nu-6_e6d4657516ee487aa83a448d64671de5_b6f3b18dbc6b428688ad1ff9df92ed41_cd67747108cd4ab0bdbc7db8b3ed47c9.jpg",
            "https://cdn.hstatic.net/products/200001061016/-6-1_015a3e3df35b42ecb268c0492ba697ad_7c43907ffa0a45d1a8699734bfcb6620_4e96688b927145db8d9e904006eb67ae.jpg",
            "https://cdn.hstatic.net/products/200001061016/-6-2_c438c03061ae4d82bbbf4ac3715ad2fa_c546aa03d283419a9499034a6c598d9d_436f17dc42124fe38a09a4edf51b768c.jpg",
            "https://cdn.hstatic.net/products/200001061016/-6-3_66f5fce1b6704ff09671fe0181ade913_ad3e70540607456291b706a75769b360_e59f7c98ca784214a698e0119076ce54.jpg",
            "https://cdn.hstatic.net/products/200001061016/-6-4_9ea31f7fb7ee42f986d2b7699359eca7_ebba53e8013f4cb7987fe682a17597cd_d70265f0a27e418989916d03ae83a6ee.jpg"
        ],
        "price": 360000,
        "originPrice": 460000,
        "shopId": "64204a17a5a97a86f12e1f0a",
        "storeId": "200001061016",
        "status": "active",
        "stock_quantity": 0,
        "search": "ao co slogan",
        "createdAt": "2025-09-16T08:32:16.611Z",
        "updatedAt": "2025-09-16T08:32:17.440Z",
        "skuDrafts": {
            "variants": [
                {
                    "key": "0",
                    "name": "Color",
                    "options": [
                        {
                            "key": "3783ac4f49ff9cd6",
                            "name": "Đen",
                            "itemVariantOptionId": "68b8126de51492ac63399a58",
                            "active": true
                        },
                        {
                            "key": "dd2c75ba8eb70eea",
                            "name": "Trắng",
                            "itemVariantOptionId": "68b8126ee51492ac63399a5f",
                            "active": true
                        },
                        {
                            "key": "d06df73d1513c74e",
                            "name": "L",
                            "itemVariantOptionId": "68b8126ee51492ac63399a64",
                            "active": true
                        },
                        {
                            "key": "fa4cbc1e1a4f669d",
                            "name": "XL",
                            "itemVariantOptionId": "68b8126ee51492ac63399a70",
                            "active": true
                        },
                        {
                            "key": "b83934a66c0c48c6",
                            "name": "M",
                            "itemVariantOptionId": "68b8126ee51492ac63399a6d",
                            "active": true
                        },
                        {
                            "key": "8cba1feea86d01e7",
                            "name": "S",
                            "itemVariantOptionId": "68b8126de51492ac63399a49",
                            "active": true
                        }
                    ],
                    "itemVarientId": "68b8126de51492ac63399a39"
                },
                {
                    "key": "0",
                    "name": "Size",
                    "options": [
                        {
                            "key": "3783ac4f49ff9cd6",
                            "name": "Đen",
                            "itemVariantOptionId": "68b8126de51492ac63399a58",
                            "active": true
                        },
                        {
                            "key": "dd2c75ba8eb70eea",
                            "name": "Trắng",
                            "itemVariantOptionId": "68b8126ee51492ac63399a5f",
                            "active": true
                        },
                        {
                            "key": "d06df73d1513c74e",
                            "name": "L",
                            "itemVariantOptionId": "68b8126ee51492ac63399a64",
                            "active": true
                        },
                        {
                            "key": "fa4cbc1e1a4f669d",
                            "name": "XL",
                            "itemVariantOptionId": "68b8126ee51492ac63399a70",
                            "active": true
                        },
                        {
                            "key": "b83934a66c0c48c6",
                            "name": "M",
                            "itemVariantOptionId": "68b8126ee51492ac63399a6d",
                            "active": true
                        },
                        {
                            "key": "8cba1feea86d01e7",
                            "name": "S",
                            "itemVariantOptionId": "68b8126de51492ac63399a49",
                            "active": true
                        }
                    ],
                    "itemVarientId": "68b8126de51492ac63399a39"
                }
            ],
            "skus": [
                {
                    "key": "3783ac4f49ff9cd6/d06df73d1513c74e",
                    "name": "Đen / L",
                    "price": 360000,
                    "stock_quantity": 0,
                    "skuId": "68c92090e51492ac6339a956",
                    "active": true
                },
                {
                    "key": "dd2c75ba8eb70eea/fa4cbc1e1a4f669d",
                    "name": "Trắng / XL",
                    "price": 360000,
                    "stock_quantity": 0,
                    "skuId": "68c92090e51492ac6339a95d",
                    "active": true
                },
                {
                    "key": "3783ac4f49ff9cd6/b83934a66c0c48c6",
                    "name": "Đen / M",
                    "price": 360000,
                    "stock_quantity": 0,
                    "skuId": "68c92090e51492ac6339a957",
                    "active": true
                },
                {
                    "key": "3783ac4f49ff9cd6/8cba1feea86d01e7",
                    "name": "Đen / S",
                    "price": 360000,
                    "stock_quantity": 0,
                    "skuId": "68c92090e51492ac6339a959",
                    "active": true
                },
                {
                    "key": "dd2c75ba8eb70eea/b83934a66c0c48c6",
                    "name": "Trắng / M",
                    "price": 360000,
                    "stock_quantity": 0,
                    "skuId": "68c92090e51492ac6339a95c",
                    "active": true
                }
            ]
        },
        "id": "68c92090e51492ac6339a955"
    }
}

select=skus,variants

Khi gọi với ?select=skus,variants, sản phẩm sẽ có thêm hai trường skus và itemVariants chứa dữ liệu hiện hành kèm ID.

{
  "success": true,
  "data": {
    "_id": "68c92090e51492ac6339a955",
    "name": "Áo có slogan",
    "price": 360000,
    "originPrice": 460000,
    "shopId": "64204a17a5a97a86f12e1f0a",
    "status": "active",
    "createdAt": "2025-09-16T08:32:16.611Z",
    "updatedAt": "2025-09-16T08:32:17.440Z",
    "skus": [
      {
        "_id": "68c92090e51492ac6339a956",
        "name": "Đen / L",
        "price": 360000,
        "originPrice": 460000,
        "stock_quantity": 0,
        "itemId": "68c92090e51492ac6339a955",
        "shopId": "64204a17a5a97a86f12e1f0a",
        "status": "active",
        "isActive": true,
        "sku": "AO-DEN-L",
        "barcode": "8938500001234",
        "variantOptionIDs": [
          "68b8126de51492ac63399a58",
          "68b8126ee51492ac63399a64"
        ],
        "createdAt": "2025-09-16T08:32:16.611Z",
        "updatedAt": "2025-09-16T08:32:16.611Z",
        "id": "68c92090e51492ac6339a956"
      },
      {
        "_id": "68c92090e51492ac6339a95d",
        "name": "Trắng / XL",
        "price": 360000,
        "originPrice": 460000,
        "stock_quantity": 0,
        "itemId": "68c92090e51492ac6339a955",
        "shopId": "64204a17a5a97a86f12e1f0a",
        "status": "inactive",
        "isActive": false,
        "sku": "AO-TRANG-XL",
        "barcode": "8938500005678",
        "variantOptionIDs": [
          "68b8126ee51492ac63399a5f",
          "68b8126ee51492ac63399a70"
        ],
        "createdAt": "2025-09-16T08:32:16.611Z",
        "updatedAt": "2025-09-16T08:32:16.611Z",
        "id": "68c92090e51492ac6339a95d"
      }
    ],
    "itemVariants": [
      {
        "_id": "68b8126de51492ac63399a39",
        "name": "Color",
        "itemId": "68c92090e51492ac6339a955",
        "isActive": true,
        "position": 0,
        "createdAt": "2025-09-16T08:32:16.611Z",
        "updatedAt": "2025-09-16T08:32:16.611Z",
        "itemVariantOptions": [
          {
            "_id": "68b8126de51492ac63399a58",
            "name": "Đen",
            "itemVariantId": "68b8126de51492ac63399a39",
            "isActive": true,
            "position": 0,
            "skuIDs": ["68c92090e51492ac6339a956"],
            "id": "68b8126de51492ac63399a58"
          },
          {
            "_id": "68b8126ee51492ac63399a5f",
            "name": "Trắng",
            "itemVariantId": "68b8126de51492ac63399a39",
            "isActive": true,
            "position": 1,
            "skuIDs": ["68c92090e51492ac6339a95d"],
            "id": "68b8126ee51492ac63399a5f"
          }
        ],
        "id": "68b8126de51492ac63399a39"
      }
    ],
    "id": "68c92090e51492ac6339a955"
  }
}

🔑ID cần dùng

• skus[]._id (hoặc skus[].id) — ID của SKU. Lưu ý API chi tiết trả về cả SKU không hoạt động (isActive: false).
• itemVariants[]._id — ID của nhóm biến thể.
• itemVariants[].itemVariantOptions[]._id — ID của tùy chọn biến thể; khớp với skus[].variantOptionIDs và itemVariantOptions[].skuIDs.