תגובות שגיאה עשויות להופיע ממגוון סיבות, כגון קריאה לא נכונה ל-API, שימוש בפרמטרים שגויים, בעיה בהרשאות או באימות, או מחיקת המשאב. אנו מציגים רק את קודי השגיאה שה-API עשוי לשלוח.
קודי שגיאה
קודי שגיאה הם קודי סטטוס HTTP מספריים, המספקים למשתמשים הקצה הודעה קצרה המתארת את הבעיה שדווחה. שגיאות אלו עלולות להשפיע על ביצועי המערכת, ויש לפתור אותן כדי שה-API יפעל כמתוכנן. בנוסף, אנו מחזירים תגובה טקסטואלית הניתנת לקריאה על ידי בני אדם.
קודי השגיאה הבאים מוחזרים על ידי ממשק ה-API הזה:
קוד שגיאה | משמעות |
400 | בקשה שגויה — הבקשה מכילה תוכן לא חוקי. |
401 | לא מורשה — מפתח ה-API שסופק אינו מורשה לבצע את הפעולה. |
403 | אסור — מפתח ה-API שסופק אינו מורשה לבצע את הפעולה. |
404 | לא נמצא — לא ניתן היה לאתר את המשאב שצוין. |
405 | שיטה אסורה -- הבקשה שצוינה אינה מותרת. |
406 | לא מקובל — הפורמט של הבקשה אינו מקובל. הפורמט הנתמך הוא json. |
409 | התנגשות - לא ניתן היה לבצע את הבקשה בשל התנגשות עם המצב הנוכחי של המשאב היעד. |
410 | נעלם — המשאב כבר אינו זמין. |
422 | ישות לא מעובדת — סתירות לוגיות בפרמטרים שסופקו. |
429 | יותר מדי בקשות — הוגשו יותר מדי בקשות עבור פרק זמן זה. |
500 | שגיאה פנימית בשרת -- אירעה שגיאה בלתי צפויה בשרת. |
503 | השירות אינו זמין — השרת מנותק לצורך תחזוקה. אנא נסה שוב מאוחר יותר. |