Ideal House
ข้ามไปยังเนื้อหา

Ideal House Product Import API#

ใช้ Product Import API เพื่อนำเข้า ดูรายการ และลบสินค้าแบบไม่ลบข้อมูลถาวรในแค็ตตาล็อก Ideal House การนำเข้าแบบกลุ่มรับสินค้า 1 ถึง 500 รายการและประมวลผลแบบอะซิงโครนัส ส่วนการดูรายการและการลบจะประมวลผลแบบซิงโครนัส

URL พื้นฐาน#

text
https://sdkapi.ideal.house

ใช้ HTTPS สำหรับคำขอทั้งหมด เนื้อหาคำขอและการตอบกลับ JSON ได้รับการเข้ารหัสเป็น UTF-8

ก่อนที่คุณจะเริ่มต้น#

Ideal House จะให้ค่าต่อไปนี้ในระหว่างการเริ่มต้นใช้งาน:

  • Shop ID
  • Client ID
  • Client Secret

Client ID และ Client Secret เป็นข้อมูลรับรองฝั่งเซิร์ฟเวอร์ ห้ามเปิดเผย Client Secret ในโค้ดเบราว์เซอร์ แอปมือถือ ที่เก็บโค้ดสาธารณะ บันทึกระบบ หรือสภาพแวดล้อมฝั่งไคลเอนต์อื่นใด

การรับรองความถูกต้อง#

รวมส่วนหัวเหล่านี้กับทุกคำขอ:

http
X-Client-Id: <YOUR_CLIENT_ID>
X-Client-Secret: <YOUR_CLIENT_SECRET>

สำหรับคำขอที่มีเนื้อหา JSON ให้รวม:

http
Content-Type: application/json

ค่า shopId ในคำขอต้องตรงกับร้านค้าที่เชื่อมโยงกับข้อมูลรับรอง หากไม่ตรงกัน ระบบจะส่งคืน 403 Forbidden

สรุป API#

วิธีการเส้นทางวัตถุประสงค์
POST/product-import/productsส่งชุดงานนำเข้าผลิตภัณฑ์แบบอะซิงโครนัส
GET/product-import/products/statusรับงานนำเข้าปัจจุบันหรือล่าสุด
GET/product-import/productsรายการสินค้าปัจจุบันของร้านค้า
DELETE/product-import/productsลบสินค้าหนึ่งรายการโดยไม่ลบข้อมูลถาวร โดยระบุรหัสสินค้าหรือ SKU

ขั้นตอนการนำเข้าเป็นกลุ่ม#

  1. ส่งชุดผลิตภัณฑ์ด้วย POST /product-import/products.
  2. บันทึก jobId ที่ได้รับในการตอบกลับ 202 Accepted
  3. สอบถาม GET /product-import/products/status ทุก 2 ถึง 5 วินาที
  4. หยุดสอบถามสถานะเมื่อสถานะเป็น completed หรือ failed
  5. หากงานมีสถานะ completed ให้ตรวจสอบ failedCount และ failures เพื่อดูข้อผิดพลาดของสินค้าแต่ละรายการ

สามารถใช้งานงานนำเข้าสำหรับร้านค้าได้ครั้งละหนึ่งงานเท่านั้น