توثيق API لإعداد الأنماط#

URL الأساسي: https://api.ideal.house
الإصدار: v1
آخر تحديث: 2026-05-21

📖 نظرة عامة#

تُرجع نقطة نهاية API لإعداد الأنماط مجموعات خيارات الأنماط المستخدمة في APIs الخاصة بالتوليد. توفر هذه الخيارات معرّفات صالحة لحقول الطلب مثل 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 المحددة بفاصلة، على سبيل المثال 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.