קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קודי הסטטוס הבאים יכולים להופיע בתגובות HTTP.
קוד HTTP
תיאור HTTP
הערות
2xx
אישור
לא שגיאה, מוחזר לאחר הצלחה. צריך להשתמש באפשרות הזו גם כשיש כשלים בלוגיקה העסקית (למשל, השדה booking_failure ב-CreateBookingResponse מאוכלס)
400
בקשה פגומה
בקשה לא חוקית/ארגומנטים לא חוקיים (לא נמצא מוכר, שירות, זמן פעילות, ניסיון להזמין זמן פעילות לא חוקי, ביטול של הזמנה שלא הייתה קיימת).
401
אין הרשאה
לא מאומת (פרטי כניסה לא חוקיים, ניסיון חוזר להתחברות). בבקשה לא מופיעים פרטי כניסה תקפים לאימות הפעולה.
403
אסור
ההרשאה נדחתה/אסורה (מבצע הקריאה ידוע ונדחה). אסור להשתמש בתגובה הזו לדחיות שנגרמות כתוצאה מיצוי משאב כלשהו (במקום זאת, צריך להשתמש ב-Too Many Requests בשביל השגיאות האלה).
אסור להשתמש ב-Forbidden אם לא ניתן לזהות את מבצע הקריאה החוזרת (במקום זאת, צריך להשתמש ב-Unauthorized בשביל השגיאות האלה).
404
לא נמצא
לא נמצא (משאב לא נמצא, כתובת URL לא חוקית, כולל RPC לא תקינים)
409
התנגשות
הפעולה בוטלה, בדרך כלל בגלל בעיה של בו-זמניות, כמו כשל בבדיקת מאסף או ביטול עסקה.
429
יותר מדי בקשות
משאב כלשהו אזל, אולי מכסה לכל משתמש, או אולי אין יותר מקום פנוי בכל מערכת הקבצים.
499
בקשה של לקוח שנסגרה
הפעולה בוטלה, בדרך כלל על ידי מבצע הקריאה החוזרת.
500
שגיאת שרת פנימית
שגיאות פנימיות. המשמעות היא שחלק מהקבועים שלא משתנים (invariants) שהמערכת הבסיסית מצפה להם הופרו. קוד השגיאה הזה מיועד לשגיאות חמורות.
501
לא בוצע יישום
הפעולה לא יושמה או לא נתמכת או לא מופעלת בשירות הזה.
503
השירות לא זמין
השירות הזה לא זמין כרגע. סביר להניח שמדובר במצב זמני, שאפשר לתקן אותו על ידי ניסיון חוזר עם זמן המתנה.
504
Gateway Timeout
מועד היעד פג לפני שהפעולה הושלמה. יכול להיות שהשגיאה הזו תוחזר גם אם הפעולה הושלמה בהצלחה, עבור פעולות שמחליפות את מצב המערכת. לדוגמה, יכול להיות שתגובה מוצלחת משרת התעכבה מספיק זמן כדי שהמועד האחרון יפוג.
לפעמים יכולים להיות כמה קודי שגיאה. שירותים צריכים להחזיר את קוד השגיאה הספציפי ביותר שרלוונטי.
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2024-11-26 (שעון UTC)."],[[["HTTP status codes indicate the outcome of a request, ranging from success (2xx) to various error types."],["Client errors (4xx) signal issues with the request itself, such as invalid credentials (401) or missing resources (404)."],["Server errors (5xx) indicate problems on the server side, including internal errors (500) or service unavailability (503)."],["When multiple error codes apply, the most specific one should be used."],["Business logic failures, despite not being technical errors, should utilize a 2xx status code with further details provided in the response body."]]],["HTTP responses can include various status codes: 2xx signifies success, used even for business logic failures. 400 indicates bad requests, 401 for unauthorized access, and 403 for forbidden actions. 404 means resource not found, 409 a conflict, and 429 too many requests. 499 denotes client-canceled operation, 500 internal errors, 501 unimplemented features, 503 service unavailability, and 504 gateway timeout. The most specific error code should be used when multiple codes apply.\n"]]
