เอกสาร API#

URLพื้นฐาน: https://api.ideal.house
เวอร์ชัน: v1
อัปเดต: 2026-05-21

📖 ภาพรวม#

ปลายทาง API คืนกลุ่มตัวเลือกสไตล์ที่ใช้โดย API สร้างภาพ ตัวเลือกเหล่านี้ให้ ID ที่ถูกต้องสำหรับฟิลด์คำขอ เช่น styleId, roomId, indoorStyleId, sceneId และพารามิเตอร์สไตล์ที่คล้ายกัน

หน้าฟีเจอร์ที่รองรับ ได้แก่:

ไฟล์ทรัพยากรปัจจุบันรวม virtual-staging.json ดังนั้น virtual_staging จึงเป็นชื่อเครื่องมือที่ใช้งานสำหรับจัดเฟอร์นิเจอร์เสมือนจริง virual_staging ที่สะกดผิดไม่ได้รับการสนับสนุนจากไฟล์ทรัพยากรปัจจุบันและคืนเนื้อหาว่าง ค่า toolName ที่ไม่ได้รับการสนับสนุนใดๆ จะคืนเนื้อหาว่าง

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

📌 เอนด์พอยต์ API#

รับค่าสไตล์#

เอนด์พอยต์

GET /api/v1/style/{toolName}/getStyles

หัวข้อความขอ

พารามิเตอร์ในเส้นทาง

📥 ตัวอย่างคำขอ#

curl -X GET "https://api.ideal.house/api/v1/style/change_furniture/getStyles" \
  -H "APIKEY: your_api_key_here"

📤 โครงสร้างคำตอบ#

เนื้อหาในคำตอบจะจัดกลุ่มตามหมวดหมู่สไตล์ แต่ละหมวดหมู่จะแมปเข้ากับพารามิเตอร์คำขอผ่าน backendParamKey

{
  "code": 0,
  "message": "success",
  "data": {
    "roomType": {
      "backendParamKey": "indoorTypeId",
      "options": [
        {
          "name": {
            "en": "Living Room",
            "zh-CN": "客厅"
          },
          "id": "Interior Design_Interior Scene_Living Room",
          "url": "https://example.com/style-preview.webp"
        }
      ]
    }
  }
}

ฟิลด์คำขอบางตัวรองรับ ID ตัวเลือกหลายค่า สำหรับฟิลด์เหล่านั้น ให้รวมค่า id ที่เลือกด้วยเครื่องหมายจุลภาค เช่น id1,id2

🧭 การแมปชื่อเครื่องมือ#

แสดงภาพแปลน#

GET /api/v1/style/ai_plan_visualizer/getStyles

เปลี่ยนเฟอร์นิเจอร์#

GET /api/v1/style/change_furniture/getStyles

ปรับปรุงภายนอก#

GET /api/v1/style/exterior_renovator/getStyles

ตกแต่งบ้าน#

GET /api/v1/style/home_decor_ideas/getStyles

ปรับปรุงการตกแต่งภายใน#

GET /api/v1/style/interoir_remodel/getStyles

ออกแบบภูมิทัศน์#

GET /api/v1/style/landscaping/getStyles

จัดเฟอร์นิเจอร์เสมือนจริง#

GET /api/v1/style/virtual_staging/getStyles

❌ การตอบสนองข้อผิดพลาด#

สำหรับค่า toolName ที่ไม่รองรับ เอนด์พอยต์จะคืนค่าว่างใน data