שגיאות וקודי שגיאה

פורמט השגיאה

לכל תשובת שגיאה יש אותו מבנה: { "error": CODE, "message": "…" }. חלק מהקודים מוסיפים שדות שעוזרים להגיב — למשל issues (מה לא תקין), required (ההרשאה החסרה), balance, feature או retryAfter.

HTTP/1.1 400 Bad Request

{
  "error": "INVALID_REQUEST",
  "message": "Invalid body",
  "issues": [{ "path": "body.amount", "message": "Number must be greater than or equal to 1" }]
}

HTTP/1.1 409 Conflict

{ "error": "INSUFFICIENT_FUNDS", "message": "The member does not have enough to remove this amount", "balance": 40 }

ב-issues, כל path מתחיל בחלק של הבקשה שהוא מתייחס אליו: params., query., body. או header..

כל קודי השגיאה

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

על אילו שגיאות לנסות שוב

• 429 RATE_LIMITED ו-503 SERVICE_UNAVAILABLE: המתינו את מספר השניות שב-Retry-After (גם ב-retryAfter) ונסו שוב.
• 500 INTERNAL ושגיאות רשת: נסו שוב עם המתנה הולכת וגדלה. בכתיבה, שלחו Idempotency-Key כדי שניסיון חוזר לעולם לא יחיל שינוי פעמיים.
• שגיאות 4xx אחרות לא ייעלמו בניסיון חוזר של אותה בקשה: תקנו קודם את הבקשה, את המפתח או את הגדרות השרת.