Foutcodereferentie voor de API#

Basis-URL: https://api.ideal.house
Versie: v1
Bijgewerkt: 2026-03-06

📖 Overzicht#

Alle API-antwoorden volgen één uniforme JSON-structuur. Bij een fout bevat het veld code een foutcode die niet nul is en geeft het veld message een leesbare beschrijving van de fout.

Uniform antwoordformaat

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

✅ Succescode#

Voorbeeld

{
  "code": 0,
  "message": "success",
  "data": { }
}

❌ Foutcodes#

🔧 Algemene fouten#

🔐 Authenticatiefouten#

🛡️ Fouten bij inhoudsmoderatie#

💰 Creditfouten#

📋 Volledig overzicht van foutcodes#

📦 Voorbeelden van foutantwoorden#

1001 — Verzoek mislukt#

{
  "code": 1001,
  "message": "Request failed",
  "data": null
}

1003 — Interne serverfout#

{
  "code": 1003,
  "message": "Internal server error",
  "data": null
}

1011 — Parameterfout#

{
  "code": 1011,
  "message": "Request parameter error: imageUrl is required",
  "data": null
}

5002 — Ongeldige API Key#

{
  "code": 5002,
  "message": "Invalid API Key",
  "data": null
}

9010 — Tekst afgekeurd bij inhoudsmoderatie#

{
  "code": 9010,
  "message": "Text prompt failed content review, contains prohibited content",
  "data": null
}

9038 — Uitvoer bevat verboden inhoud#

{
  "code": 9038,
  "message": "Prohibited content",
  "data": null
}

9051 — Onvoldoende credits#

{
  "code": 9051,
  "message": "Insufficient coins",
  "data": null
}

💡 Aanbevolen foutafhandeling#

1. Controleer altijd code — Vertrouw niet uitsluitend op HTTP-statuscodes; inspecteer altijd het veld code in de antwoordinhoud.
2. Handel 1001 dynamisch af — Dit is een algemene foutcode; het veld message bevat de specifieke reden.
3. Probeer opnieuw bij 1003 — Serverfouten zijn meestal tijdelijk; implementeer herpogingen met exponentieel oplopende wachttijden.
4. Valideer invoer vóór verzending — Voorkom 1011-fouten door verplichte velden op de client te valideren voordat je de API-aanroep uitvoert.
5. Inhoudsmoderatie — Als je 9010 of 9038 ontvangt, controleer je inhoud dan aan de hand van het inhoudsbeleid van het platform voordat je deze opnieuw indient.

© Ideal House AI — Alle rechten voorbehouden.