رموز الأخطاء

فهم استجابات أخطاء API وكيفية معالجتها.

نظرة عامة

يُرجع API استجابات أخطاء موحدة مع رموز أخطاء محددة لمساعدتك في تحديد المشكلات وحلها بسرعة.

تنسيق استجابة الخطأ

تتبع جميع استجابات الأخطاء هذا الهيكل:

{
  "status": "error",
  "error": {
    "code": "AUTH_1001",
    "message": "بيانات اعتماد المصادقة مفقودة",
    "details": "حقول 'username' و 'password' مطلوبة كلاهما",
    "timestamp": "2025-12-22T10:30:00Z"
  }
}

أخطاء المصادقة (1000-1099)

أخطاء متعلقة ببيانات الاعتماد والمصادقة.

أخطاء الحصة (1100-1199)

أخطاء متعلقة بحصة API وحدود الاستخدام.

أخطاء التحقق (2000-2099)

أخطاء متعلقة بالتحقق من الطلب وبيانات الإدخال.

أخطاء المعالجة (3000-3099)

أخطاء أثناء معالجة المستند وتحليل الذكاء الاصطناعي.

أخطاء الخادم (5000-5099)

أخطاء خادم داخلية ومشاكل توفر الخدمة.

أفضل ممارسات معالجة الأخطاء

مثال معالجة الأخطاء (JavaScript)

async function analyzeBloodTest(file) {
  try {
    const response = await fetch(API_URL, {
      method: 'POST',
      body: formData
    });

    const data = await response.json();

    if (data.status === 'error') {
      const errorCode = data.error.code;

      switch (true) {
        case errorCode.startsWith('AUTH_'):
          throw new Error('فشلت المصادقة. تحقق من بيانات اعتمادك.');
        case errorCode.startsWith('QUOTA_'):
          throw new Error('تم تجاوز الحصة. يرجى ترقية خطتك.');
        case errorCode.startsWith('VAL_'):
          throw new Error('طلب غير صالح: ' + data.error.message);
        case errorCode.startsWith('PROC_'):
          // أعد المحاولة لأخطاء المعالجة
          return retryRequest(file);
        default:
          throw new Error('حدث خطأ. يرجى المحاولة مرة أخرى.');
      }
    }

    return data.data;
  } catch (error) {
    console.error('خطأ API:', error);
    throw error;
  }
}