⚠️

טיפול בשגיאות

קודי שגיאה ואיך לטפל בהם

מבנה שגיאה

כל שגיאה מוחזרת במבנה אחיד:

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable error message",
    "details": { ... }  // optional
  }
}

קודי HTTP

קודמשמעותתיאור
200OKהבקשה הצליחה
400Bad Requestהבקשה שגויה או חסרים פרמטרים
401Unauthorizedמפתח API חסר או שגוי
403Forbiddenאין הרשאה לבצע את הפעולה
404Not Foundהמשאב המבוקש לא נמצא
429Too Many Requestsחריגה ממגבלת קצב
500Internal Server Errorשגיאה פנימית בשרת

קודי שגיאה

קודתיאור
UNAUTHORIZEDמפתח API חסר או לא תקין
FORBIDDENאין הרשאות מספיקות
INVALID_PARAMSפרמטרים שגויים או חסרים
NOT_FOUNDהמשאב לא נמצא
RATE_LIMIT_EXCEEDEDחריגה ממגבלת הקצב
PLAN_LIMIT_EXCEEDEDחריגה ממגבלות התכנית
INTERNAL_ERRORשגיאה פנימית בשרת

המלצות לטיפול

1.
בדוק תמיד את שדה success
לפני שימוש ב-data, וודא ש-success הוא true
2.
ממש retry אוטומטי
עבור שגיאות 429 ו-500, השתמש ב-exponential backoff
3.
רשום שגיאות
שמור את קוד השגיאה וה-message לצורך דיבוג