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