קודי שגיאה וסטטוסים - מדריך

מדריך מקיף לקודי שגיאה של Smart Money API, קודי סטטוס HTTP ושלבי פתרון בעיות. הבנת תגובות שגיאה ופתרון בעיות אינטגרציה במהירות.

קודי הצלחה 2xx

תגובות הצלחה מציינות שהבקשה עובדה בהצלחה.

קוד	סטטוס	משמעות
200	OK	הבקשה הצליחה. גוף התגובה מכיל את הנתונים המבוקשים.
201	Created	המשאב נוצר בהצלחה. התגובה כוללת את המשאב החדש.
204	No Content	הבקשה הצליחה אך אין תוכן להחזיר (למשל, DELETE).

דוגמת תגובה 200

JSON

{
  "success": true,
  "data": {
    "total": 42,
    "positions": [...],
    "pagination": {
      "page": 1,
      "limit": 50
    }
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

קודי שגיאת לקוח 4xx

שגיאות לקוח מציינות שהבקשה הייתה פגומה או לא חוקית. תקן את הבקשה ונסה שוב.

קוד	סטטוס	סיבה
400	Bad Request	תחביר בקשה פגום. בדוק פרמטרי שאילתה, כותרות וגוף הבקשה.
401	Unauthorized	אימות חסר או לא חוקי. בדוק את מפתח ה-API או אסימון ה-JWT שלך.
402	Payment Required	תשלום המנוי שלך נכשל. עדכן את פרטי החיוב בחשבונך.
403	Forbidden	מאומת אך לא מורשה למשאב זה. התוכנית שלך לא כוללת תכונה זו.
404	Not Found	המשאב לא קיים. בדוק את כתובת ה-URL והפרמטרים של הנתיב.
429	Too Many Requests	חריגה ממגבלת הקצב. המתן לפני ניסיון חוזר. בדוק את כותרת Retry-After.
422	Unprocessable Entity	אימות נכשל. פרמטרי הבקשה לא חוקיים או שדות חובה חסרים.

דוגמאות לשגיאות אימות

מפתח API חסר (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_MISSING_KEY",
    "message": "אימות חסר.",
    "resolution": "הוסף את מפתח ה-API שלך לכותרת Authorization: Authorization: Bearer sk_live_..."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

מפתח API לא חוקי (401)

JSON

{
  "success": false,
  "error": {
    "code": "AUTH_INVALID_KEY",
    "message": "מפתח API לא חוקי או שפג תוקפו.",
    "resolution": "צור מפתח API חדש מהקונסול שלך בכתובת https://smartmoneyapi.com/console"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

הגבלת קצב (429)

כאשר אתה חורג ממכסת ה-API שלך, השרת מחזיר 429 Too Many Requests. בדוק את כותרות התגובה למידע על הגבלת הקצב:

כותרות HTTP

X-Requests-Remaining: 0
X-Requests-Limit: 200
X-Requests-Reset: 1711116922
Retry-After: 3600

תגובת שגיאת הגבלת קצב

JSON

{
  "success": false,
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "חריגה ממגבלת הבקשות היומית (10).",
    "resolution": "שדרג לתוכנית Trader (29$/חודש, 400 בקשות/יום) או Pro (79$/חודש, 4,000 בקשות/יום).",
    "reset_at": "2026-03-22T09:00:00Z"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

שגיאות אימות (422)

שגיאות אימות מתרחשות כאשר פרמטרי הבקשה שלך לא חוקיים או שדות חובה חסרים.

JSON

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "אימות הבקשה נכשל.",
    "details": [
      {
        "field": "symbol",
        "error": "צמד מסחר לא חוקי. פורמט מצופה: BTCUSDT"
      },
      {
        "field": "min_position_size",
        "error": "חייב להיות מספר חיובי"
      }
    ],
    "resolution": "תקן את שגיאות האימות ונסה שוב."
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

קודי שגיאת שרת 5xx

שגיאות שרת מציינות בעיה בצד שלנו. אלו זמניות ובדרך כלל נפתרות במהירות. יש ליישם לוגיקה של ניסיונות חוזרים עם השהייה מעריכית.

קוד	סטטוס	פעולה
500	Internal Error	שגיאת שרת בלתי צפויה. נסה שוב עם השהייה מעריכית.
502	Bad Gateway	הפרעת שירות זמנית. נסה שוב לאחר מספר שניות.
503	Service Unavailable	תקלה זמנית או תחזוקה. בדוק דף סטטוס. נסה שוב לאחר מרווח Retry-After.
504	Gateway Timeout	הבקשה ארכה זמן רב מדי. ייתכן שהשרת עיבד אותה בכל מקרה. בדוק idempotency.

דוגמת שגיאת שרת (503)

JSON

{
  "success": false,
  "error": {
    "code": "SERVICE_UNAVAILABLE",
    "message": "השירות זמנית לא זמין עקב תחזוקה.",
    "resolution": "אנא נסה שוב לאחר 5 דקות. עקוב אחר סטטוס בכתובת https://status.smartmoneyapi.com"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

מדריך לפתרון בעיות

401 Unauthorized - מפתח API לא חוקי

בעיה: מקבל שגיאות 401 למרות שיש מפתח API.

פתרונות:

וודא שמפתח ה-API כלול בכותרת Authorization עם הקידומת "Bearer"
בדוק שמפתח ה-API שלך לא פג תוקף או בוטל
ודא שאתה משתמש במפתח הנכון (production, staging, או development)
צור מפתח API חדש מהקונסול שלך אם הנוכחי אבד

403 Forbidden - תכונה לא זמינה

בעיה: מקבל שגיאות 403 בנתיבים מסוימים.

פתרונות:

בדוק את רמת ה-API שלך. חלק מהנתיבים דורשים תוכניות Trader או Pro
שדרג את התוכנית שלך ב-/pricing.html כדי לגשת לתכונות פרימיום
ודא שלמפתח ה-API יש את ההרשאות הנדרשות מופעלות
צור קשר עם התמיכה אם אתה מאמין שאמור להיות לך גישה

429 Too Many Requests - הגבלת קצב

בעיה: מקבל שגיאות 429 ומוגבל בקצב.

פתרונות:

יישם לוגיקה של ניסיונות חוזרים עם השהייה מעריכית (המתן 1 שנייה, 2 שניות, 4 שניות וכו')
שמור תגובות במטמון כדי להימנע מקריאות API מיותרות
השתמש ב-WebSocket לקבלת נתונים בזמן אמת במקום לשאול נקודות קצה REST
שדרג את התוכנית שלך למכסות גבוהות יותר (Trader 1,000/יום, Pro 5,000/יום)
אצור מספר שאילתות לבקשה אחת במקום אפשר

400 Bad Request - פרמטרים לא חוקיים

בעיה: מקבל שגיאות 400 עם בקשות פגומות.

פתרונות:

בדוק את תיעוד ה-API עבור פרמטרים נדרשים ואופציונליים
וודא את סוגי הפרמטרים (מחרוזות לעומת מספרים, מערכים לעומת אובייקטים)
ודא שה-JSON חוקי ומעוצב כראוי
השתמש בכתובות URL נכונות של נקודות קצה עם פרמטרי נתיב מתאימים
בדוק שגיאות הקלדה בשמות פרמטרי השאילתה

שגיאות שרת 5xx - השבתות זמניות

בעיה: מקבל שגיאות 500, 502, 503, או 504.

פתרונות:

בדוק את מצב השירות ב-https://status.smartmoneyapi.com
יישם ניסיון חוזר אוטומטי עם השהיה מעריכית (מקסימום 5-10 ניסיונות)
המתן 30-60 שניות לפני ניסיון חוזר בשגיאות 503
השתמש בכותרת Retry-After כדי לקבוע את זמן הניסיון החוזר
הירשם לעמוד המצב לקבלת התראות על תקלות

פורמט תגובת שגיאה

כל תגובות השגיאה עוקבות אחר פורמט עקבי:

JSON

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "הודעת שגיאה קריאה",
    "details": {...},
    "resolution": "צעדים לפתרון הבעיה"
  },
  "timestamp": "2026-03-21T14:35:22Z"
}

צריך עזרה נוספת?

בדוק את תיעוד ה-API שלנו או פנה לתמיכה עם קוד השגיאה ופרטי הבקשה שלך.

הפניית API

קבל תמיכה

יש שאלות? בדוק את התיעוד שלנו או פנה לתמיכה.

פתח קונסולה