API-Fehlercodereferenz#

Basis-URL: https://api.ideal.house
Version: v1
Aktualisiert: 2026-03-06

📖 Übersicht#

Alle API-Antworten folgen einer einheitlichen JSON-Struktur. Tritt ein Fehler auf, enthält das Feld code einen Fehlercode ungleich null, und das Feld message liefert eine menschenlesbare Fehlerbeschreibung.

Einheitliches Antwortformat

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

✅ Erfolgscode#

Beispiel

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

❌ Fehlercodes#

🔧 Allgemeine Fehler#

🔐 Authentifizierungsfehler#

🛡️ Fehler bei der Inhaltsmoderation#

💰 Guthabeneinheiten-Fehler#

📋 Vollständige Fehlercodeübersicht#

📦 Fehlerantwortbeispiele#

1001 — Anfrage fehlgeschlagen#

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

1003 — Interner Serverfehler#

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

1011 — Parameterfehler#

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

5002 — Ungültiger API Key#

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

9010 — Moderation des Textinhalts fehlgeschlagen#

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

9038 — Ausgabe verbotene Inhalte#

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

9051 — Unzureichende Guthabeneinheiten#

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

💡 Bewährte Vorgehensweisen zur Fehlerbehandlung#

1. Prüfen Sie stets code — Verlassen Sie sich nicht ausschließlich auf HTTP-Statuscodes; prüfen Sie immer das Feld code im Antwortkörper.
2. Behandeln Sie 1001 dynamisch — Dies ist ein generischer Fehlercode; das Feld message enthält den spezifischen Grund.
3. Wiederholen bei 1003 — Serverseitige Fehler sind meist vorübergehend; implementieren Sie Exponential-Backoff-Wiederholungslogik.
4. Validieren Sie Eingaben vor dem Senden — Vermeiden Sie 1011-Fehler, indem Sie erforderliche Felder clientseitig validieren, bevor Sie den API-Aufruf tätigen.
5. Inhaltsmoderation – Wenn Sie 9010 oder 9038 erhalten, überprüfen Sie Ihren Inhalt vor dem erneuten Einreichen gemäß der Inhaltsrichtlinie der Plattform.

© Ideal House AI — Alle Rechte vorbehalten.