مرجع رموز خطأ API#

URL الأساسي: https://api.ideal.house
الإصدار: v1
آخر تحديث: 2026-03-06

📖 نظرة عامة#

جميع استجابات API تتبع بنية JSON موحدة. عند حدوث خطأ، سيحتوي الحقل code على رمز خطأ غير صفري، وسيوفر الحقل message وصفًا مقروءًا للبشر للخطأ.

تنسيق الاستجابة الموحد

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

✅ رمز النجاح#

مثال

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

❌ رموز الخطأ#

🔧 أخطاء عامة#

🔐 أخطاء المصادقة#

🛡️ أخطاء الرقابة على المحتوى#

💰 أخطاء الرصيد#

📋 ملخص رموز الخطأ الكامل#

📦 أمثلة على استجابات الخطأ#

1001 — فشل الطلب#

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

1003 — خطأ في الخادم الداخلي#

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

1011 — خطأ في المعلمة#

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

5002 — مفتاح API غير صالح#

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

9010 — فشل رقابة محتوى النص#

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

9038 — محتوى محظور في الإخراج#

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

9051 — رصيد غير كافٍ#

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

💡 أفضل ممارسات التعامل مع الأخطاء#

1. تحقق دائمًا من code — لا تعتمد فقط على رموز حالة HTTP; افحص دائمًا حقل code في جسم الاستجابة.
2. عالج 1001 بشكل ديناميكي — هذا رمز خطأ عام؛ سيحتوي حقل message على السبب المحدد.
3. أعد المحاولة عند 1003 — أخطاء جانب الخادم عادة ما تكون عابرة؛ نفذ منطق إعادة المحاولة مع زيادة فترات الانتظار أُسّيًا.
4. تحقق من المدخلات قبل الإرسال — تجنّب أخطاء 1011 بالتحقق من الحقول المطلوبة على جانب العميل قبل إجراء استدعاء API.
5. الرقابة على المحتوى — إذا تلقيت 9010 أو 9038، راجع محتواك مقابل سياسة المحتوى على المنصة قبل إعادة الإرسال.

© Ideal House ذكاء اصطناعي — جميع الحقوق محفوظة.