API Stil Yapılandırması Belgelendirmesi#

Temel URL: https://api.ideal.house
Sürüm: v1
Güncellendi: 2026-05-21

📖 Genel Bakış#

API Stil Yapılandırması uç noktası, üretim API'leri tarafından kullanılan stil seçenek gruplarını döndürür. Bu seçenekler, styleId, roomId, indoorStyleId, sceneId ve benzeri stil parametreleri gibi istek alanları için geçerli kimlik numaraları sağlar.

Desteklenen özellik sayfaları şunları içerir:

Mevcut kaynak dosyaları virtual-staging.json içerdiğinden, Sanal Sahneleme için çalışan araç adı virtual_staging'dur. Yanlış yazılmış virual_staging, mevcut kaynak dosyasıyla desteklenmemektedir ve boş içerik döndürür. Desteklenmeyen herhangi bir toolName boş içerik döndürür.

🔐 Kimlik Doğrulama#

📌 API Uç Nokta#

Stil Yapılandırmasını Getirme#

Uç nokta

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

İstek Başlıkları

Yol Parametreleri

📥 İstek Örneği#

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

📤 Yanıt Yapısı#

Yanıt gövdesi stil kategorisine göre gruplandırılır. Her kategori, backendParamKey üzerinden bir istek parametresine eşlenir.

{
  "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"
        }
      ]
    }
  }
}

Bazı istek alanları birden fazla seçenek kimlik numarasını destekler. Bu alanlar için seçilen id değerlerini virgülle birleştirin, örneğin id1,id2.

🧭 Araç Adı Eşlemesi#

Plan Görselleştirici#

GET /api/v1/style/ai_plan_visualizer/getStyles

Mobilya Değiştirme#

GET /api/v1/style/change_furniture/getStyles

Dış Cephe Yenileme#

GET /api/v1/style/exterior_renovator/getStyles

Ev Dekorasyonu#

GET /api/v1/style/home_decor_ideas/getStyles

İç Mekan Yenileme#

GET /api/v1/style/interoir_remodel/getStyles

Peyzaj Tasarımı#

GET /api/v1/style/landscaping/getStyles

Sanal Sahneleme#

GET /api/v1/style/virtual_staging/getStyles

❌ Hata Yanıtları#

Desteklenmeyen toolName değerleri için uç nokta, data içinde boş içerik döndürür.