משמעות השגיאה
הבקשה אינה תקינה מבחינה תחבירית או סמנטית: גוף בקשה שגוי במבנהו, שדה חובה חסר או ערך פרמטר החורג מהטווח המותר. כאשר ניתן לייחס את הבעיה לפרמטר יחיד, השדהparam מציין את שמו.
תגובת 409 מצביעה על כך שהבקשה סותרת את המצב הנוכחי של המשאב. לדוגמה, יצירת לקוח OAuth עלולה להיכשל משום שחשבון השירות היעד אינו פעיל, חסרה בו הרשאה שהתבקשה, או שהוא הגיע למגבלת הלקוחות שלו. יש לבדוק יחד את status ואת detail; קוד השגיאה לבדו אינו מבחין בין מצבים אלה לבין בקשה שגויה במבנהּ.
כיצד לפעול
- עיינו ב-
detailוב-param— הם מתארים בדיוק מה נכשל באימות. - עבור
400, תקנו את הבקשה לפני שליחתה מחדש. - עבור
409, יש לפתור תחילה את הקונפליקט במצב החשבון, בהרשאה או בקיבולת. לקוח OAuth הממתין לניקוי עדיין תופס קיבולת. יש לשמור את מפתח הניסיון החוזר (retry key) בעת ניסיון חוזר של אותה יצירה לאחר פתרון הקונפליקט. - עיינו במסמך ה-API reference כדי לבדוק את שדות החובה, הסוגים והערכים המותרים של הפעולה.