API Hata Kodu Referansı#

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

📖 Genel Bakış#

Tüm API yanıtları birleşik bir JSON yapısını izler. Bir hata oluştuğunda, code alanı sıfır olmayan bir hata kodu içerir ve message alanı hatanın insan okunabilir açıklamasını sağlar.

Birleşik Yanıt Biçimi

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

✅ Başarı Kodu#

Örnek

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

❌ Hata Kodları#

🔧 Genel Hatalar#

🔐 Kimlik Doğrulama Hataları#

🛡️ İçerik Denetimi Hataları#

💰 Kredi Hataları#

📋 Kapsamlı Hata Kodu Özeti#

📦 Hata Yanıtı Örnekleri#

1001 — İstek Başarısız#

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

1003 — Dahili Sunucu Hatası#

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

1011 — Parametre Hatası#

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

5002 — Geçersiz API Anahtarı#

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

9010 — Metin İçerik Denetimi Başarısız#

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

9038 — Yasaklı Çıktı İçeriği#

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

9051 — Yetersiz Kredi#

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

💡 Hata Yönetimi İçin En İyi Uygulamalar#

1. Her zaman code alanını kontrol edin — Yalnızca HTTP durum kodlarına güvenmeyin; yanıt gövdesindeki code alanını her zaman inceleyin.
2. 1001 kodunu dinamik olarak yönetin — Bu genel bir hata kodudur; message alanı spesifik nedeni içerir.
3. 1003 durumunda yeniden deneyin — Sunucu tarafı hataları genellikle geçicidir; üstel geri çekilme (exponential backoff) yeniden deneme mantığı uygulayın.
4. Göndermeden önce girdileri doğrulayın — 1011 hatalarından kaçınmak için API çağrısını yapmadan önce zorunlu alanları istemci tarafında doğrulayın.
5. İçerik denetimi — 9010 veya 9038 alırsanız, yeniden göndermeden önce içeriğinizi platformun İçerik Politikası ile karşılaştırarak inceleyin.

© Ideal House AI — Tüm hakları saklıdır.