Documentatie voor API-stijlconfiguratie#

Basis-URL: https://api.ideal.house
Versie: v1
Bijgewerkt: 2026-05-21

📖 Overzicht#

Het endpoint voor API-stijlconfiguratie retourneert groepen stijlopties die generatie-API's gebruiken. Deze opties leveren geldige ID's voor verzoekvelden zoals styleId, roomId, indoorStyleId, sceneId en vergelijkbare stijlparameters.

Ondersteunde functiepagina's zijn:

De huidige bronbestanden bevatten virtual-staging.json, dus virtual_staging is de werkende toolnaam voor virtuele inrichting. De verkeerd gespelde virual_staging wordt niet door het huidige bronbestand ondersteund en retourneert lege inhoud. Elke niet-ondersteunde toolName retourneert lege inhoud.

🔐 Authenticatie#

📌 API-eindpunt#

Stijlconfiguratie ophalen#

Eindpunt

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

Verzoekheaders

Padparameters

📥 Verzoekvoorbeeld#

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

📤 Antwoordstructuur#

De antwoordinhoud is gegroepeerd per stijlcategorie. Elke categorie wordt via backendParamKey aan een verzoekparameter gekoppeld.

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

Sommige verzoekvelden ondersteunen meerdere optie-ID's. Verbind voor die velden de geselecteerde id-waarden met een komma, bijvoorbeeld id1,id2.

🧭 Koppeling van toolnamen#

Planvisualisatie#

GET /api/v1/style/ai_plan_visualizer/getStyles

Meubelvervanging#

GET /api/v1/style/change_furniture/getStyles

Buitenrenovatie#

GET /api/v1/style/exterior_renovator/getStyles

Kamerdecoratie#

GET /api/v1/style/home_decor_ideas/getStyles

Interieurrenovatie#

GET /api/v1/style/interoir_remodel/getStyles

Tuinontwerp#

GET /api/v1/style/landscaping/getStyles

Virtuele inrichting#

GET /api/v1/style/virtual_staging/getStyles

❌ Foutantwoorden#

Voor niet-ondersteunde toolName-waarden retourneert het endpoint lege inhoud in data.