รายการผลิตภัณฑ์#

ส่งคืนรายการสินค้าของร้านค้าแบบแบ่งหน้า สินค้าที่ไม่ใช้งานและสินค้าหมดสต็อกยังคงอยู่ในรายการ แต่สินค้าที่มี status: invalid รวมถึงสินค้าที่ถูกลบแบบไม่ลบข้อมูลถาวรจะถูกยกเว้น

http

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#

bash

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>'

การตอบสนอง#

json

{
  "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 เพื่อเรียกข้อมูลทีละหน้าจนกว่าจะได้สินค้าครบทั้งหมดเสมอ อย่าถือว่าการตอบกลับเพียงครั้งเดียวมีแค็ตตาล็อกครบทั้งหมด