Lấy danh sách sản phẩm
API này giúp bạn lấy danh sách các sản phẩm có trong hệ thống.
Bạn có thể sử dụng các tham số (params) như page, limit để phân trang kết quả trả về.
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
http GET https://staging-manage.api.miniai.vn/api/external/v1/products
Example
https://staging-manage.api.miniai.vn/api/external/v1/products?limit=5&page=1
🔗Endpoint Production
http GET https://manage-api.miniap.vn/api/external/v1/products
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 |
Về shopId
Bạn không cần truyền shopId. Hệ thống tự động xác định cửa hàng dựa trên
API key của bạn.
Tham số truy vấn (Query Parameters)
Tất cả tham số đều là tùy chọn.
| Tham số | Kiểu | Yêu cầu | Mặc định | Mô tả |
|---|---|---|---|---|
page | number | Tùy chọn | 1 | Trang cần lấy |
limit | number | Tùy chọn | 10 | Số sản phẩm mỗi trang (tối đa 50) |
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) |
search | string | Tùy chọn | — | Tìm kiếm theo tên/mã sản phẩm |
category | string | Tùy chọn | — | Lọc theo ID danh mục |
minPrice | number | Tùy chọn | — | Lọc theo giá tối thiểu |
maxPrice | number | Tùy chọn | — | Lọc theo giá tối đa |
barcode | string | Tùy chọn | — | Tìm chính xác 1 sản phẩm theo mã vạch (luôn kèm skus) |
warehouseId | string | Tùy chọn | — | Trả về thêm tồn kho (warehouseStock) của từng SKU tại kho chỉ định |
sortBy | string | Tùy chọn | createdAt | Trường dùng để sắp xếp |
sortType | string | Tùy chọn | desc | asc hoặc desc |
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), chỉ gồm SKU đang hoạt động |
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) |
category | Trả về thông tin danh mục đầy đủ |
wholesalePrices | Trả về bảng giá sỉ |
subItemsGroups | Trả về nhóm sản phẩm con |
skuDrafts và dữ liệu biến thể mới nhất
Mặc định mỗi 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. Đây là ảnh chụp (snapshot) và có thể không phản ánh các chỉnh sửa biến thể/SKU sau này.
Để 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 đó:
skuschứa các SKU hiện hành, mỗi phần tử có_id(ID SKU) vàvariantOptionIDs.itemVariantschứ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).
Example — lấy kèm biến thể và SKU
https://staging-manage.api.miniai.vn/api/external/v1/products?limit=5&page=1&select=skus,variants
Phản hồi (Response)
- Mặc định (có skuDrafts)
- select=skus,variants
{
"success": true,
"data": {
"products": [
{
"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"
}
],
"meta": {
"total": 4445,
"totalPages": 4445,
"currentPage": 1,
"limit": 1
}
}
}
Khi gọi với ?select=skus,variants, mỗi 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": {
"products": [
{
"_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": "active",
"isActive": true,
"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"
}
],
"meta": {
"total": 4445,
"totalPages": 4445,
"currentPage": 1,
"limit": 1
}
}
}
🔑ID cần dùng
skus[]._id(hoặcskus[].id) — ID của SKU.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ớiskus[].variantOptionIDsvàitemVariantOptions[].skuIDs.