ניתן להחזיר את קודי המצב הבאים בתגובות HTTP.
קוד HTTP | תיאור HTTP | הערות |
---|---|---|
2xx | אישור | זו לא שגיאה. הוחזרה בהצלחה. צריך להשתמש בו גם במקרים של כשלים בלוגיקה העסקית
(למשל, הערך booking_failure בשדה
CreateBookingResponse
מאוכלס) |
400 | בקשה פגומה | בקשה שגויה/ארגומנטים לא תקינים (מוכר, שירות, יחידת קיבולת לא נמצא, ניסיון להזמין משבצת לא חוקית, ביטול הזמנה שמעולם לא הייתה קיימת). |
401 | לא מורשה | לא מאומת (פרטי כניסה לא חוקיים, יש לנסות להתחבר שוב). לבקשה אין פרטי כניסה תקפים לביצוע הפעולה. |
403 | אסור | הרשאה נדחתה/אסור (המתקשר מוכר ונדחה). אי אפשר להשתמש בתשובה הזו במקרים של דחיות שנגרמו כתוצאה ממיצוי המשאב (יש להשתמש בפונקציה Too Many Requests במקום זאת).
אין להשתמש ב-Forbidden אם לא ניתן לזהות את המתקשר (יש להשתמש ב-Unauthorized במקום זאת לשגיאות האלה). |
404 | לא נמצא | לא נמצא (המשאב לא נמצא, כתובת URL לא חוקית, כולל RPCs לא חוקיים) |
409 | בהתנגשות | הפעולה בוטלה, לרוב עקב בעיית בו-זמנית, כמו כשל בבדיקת רצף או ביטול עסקה. |
429 | יותר מדי בקשות | חלק מהמשאב נוצל, יכול להיות המכסה למשתמש או שאין מספיק נפח אחסון במערכת הקבצים. |
499 | בקשה סגורה של לקוח | הפעולה בוטלה, בדרך כלל על ידי המתקשר. |
500 | שגיאת שרת פנימית | שגיאות פנימיות. המשמעות היא שחלק מהמשתנים שצפויים על ידי המערכת הבסיסית לא תקינים. קוד השגיאה הזה שמור לשגיאות חמורות. |
501 | לא הוטמע | הפעולה לא מוטמעת או לא נתמכת או מופעלת בשירות הזה. |
503 | השירות לא זמין | השירות הזה לא זמין כרגע. סביר להניח שזהו מצב זמני, שאפשר לתקן אותו על ידי ניסיון חוזר באמצעות השהיה (backoff). |
504 | הזמן הקצוב לתפוגת השער הסתיים | המועד האחרון חלף לפני שהפעולה הסתיימה. לגבי פעולות שמשנות את מצב המערכת, ייתכן שהשגיאה הזו תוחזר גם אם הפעולה הושלמה בהצלחה. לדוגמה, יכול להיות שתגובה מוצלחת משרת התעכבה מספיק עד שהתוקף של המועד האחרון יפוג. |
לפעמים יכולים להופיע כמה קודי שגיאה. השירותים אמורים להחזיר את קוד השגיאה הספציפי ביותר.