⚠️
טיפול בשגיאות
קודי שגיאה ואיך לטפל בהם
מבנה שגיאה
כל שגיאה מוחזרת במבנה אחיד:
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Human-readable error message",
"details": { ... } // optional
}
}קודי HTTP
| קוד | משמעות | תיאור |
|---|---|---|
| 200 | OK | הבקשה הצליחה |
| 400 | Bad Request | הבקשה שגויה או חסרים פרמטרים |
| 401 | Unauthorized | מפתח API חסר או שגוי |
| 403 | Forbidden | אין הרשאה לבצע את הפעולה |
| 404 | Not Found | המשאב המבוקש לא נמצא |
| 429 | Too Many Requests | חריגה ממגבלת קצב |
| 500 | Internal 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 לצורך דיבוג
