קודי שגיאה

הבן תגובות שגיאה של ה-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)

שגיאות במהלך עיבוד מסמך וניתוח AI.

שגיאות שרת (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;
  }
}