قائمة المنتجات#
يعيد منتجات المتجر مقسمة إلى صفحات. تظل المنتجات غير النشطة وغير المتوفرة في المخزون مدرجة. تُستبعد المنتجات ذات status: invalid، بما فيها المنتجات المحذوفة منطقيًا.
GET https://sdkapi.ideal.house/product-import/products?shopId=<SHOP_ID>&page=1&pageSize=20
معلمات الاستعلام#
| الميدان | النوع | مطلوب | القيود | الوصف |
|---|---|---|---|---|
shopId | string | نعم | الحد الأقصى 64 حرفا | معرف المتجر مقدم من Ideal House. (Shop ID) |
page | number | لا | عدد صحيح أكبر من أو يساوي 1 | رقم الصفحة. القيمة الافتراضية هي 1. |
pageSize | number | لا | عدد صحيح من 1 إلى 100 | المنتجات لكل صفحة. القيمة الافتراضية هي 20. |
مثال cURL#
curl --request GET \
'https://sdkapi.ideal.house/product-import/products?shopId=shop_123&page=1&pageSize=20' \
--header 'X-Client-Id: <YOUR_CLIENT_ID>' \
--header 'X-Client-Secret: <YOUR_CLIENT_SECRET>'
الاستجابة#
{
"items": [
{
"id": "product_123",
"shopId": "shop_123",
"sku": "SKU-10001",
"productCode": "SKU-10001",
"externalProductId": "SKU-10001",
"groupId": "mirror-series-01",
"collectionId": null,
"name": "Gold Wall Mirror",
"title": "Gold Wall Mirror",
"brand": "Example Brand",
"productType": "Wall Art",
"normalizedProductType": "wall_decors",
"category": "Mirror",
"style": null,
"color": "Gold",
"availability": "active",
"imageUrl": "https://cdn.ideal.house/products/product_123.png",
"previewImageUrl": "https://cdn.ideal.house/products/product_123-preview.png",
"productUrl": "https://www.example.com/products/SKU-10001",
"attributes": {
"size": {
"width": "24.0 in",
"height": "36.0 in",
"thickness": "2.0 in"
}
},
"status": "active",
"createdAt": "2026-07-21T06:30:00.000Z",
"updatedAt": "2026-07-21T06:30:08.000Z"
}
],
"total": 1,
"page": 1,
"pageSize": 20
}
استخدم دائمًا total وpage وpageSize للتنقل بين الصفحات حتى تسترجع جميع المنتجات. لا تفترض أن استجابة واحدة تحتوي على الكتالوج كاملًا.