קודי מצב HTTP
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
קודי הסטטוס הבאים יכולים להופיע בתגובות 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 |
מועד היעד פג לפני שהפעולה הושלמה. יכול להיות שהשגיאה הזו תוחזר גם אם הפעולה הושלמה בהצלחה, עבור פעולות שמחליפות את מצב המערכת. לדוגמה, יכול להיות שתגובה מוצלחת משרת התעכבה מספיק זמן כדי שהמועד האחרון יפוג. |
לפעמים יכולים להיות כמה קודי שגיאה. שירותים צריכים להחזיר את קוד השגיאה הספציפי ביותר שרלוונטי.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-07-26 (שעון UTC).
[null,null,["עדכון אחרון: 2025-07-26 (שעון UTC)."],[[["\u003cp\u003eHTTP status codes indicate the outcome of a request, ranging from success (2xx) to various error types.\u003c/p\u003e\n"],["\u003cp\u003eClient errors (4xx) signal issues like bad requests, authentication failures, or missing resources.\u003c/p\u003e\n"],["\u003cp\u003eServer errors (5xx) represent problems on the server side, such as internal errors or service unavailability.\u003c/p\u003e\n"],["\u003cp\u003eSpecific error codes provide detailed information about the nature of the problem, enabling appropriate action.\u003c/p\u003e\n"],["\u003cp\u003eWhen multiple error codes could apply, the most specific one should be returned.\u003c/p\u003e\n"]]],["HTTP responses can include various status codes. Successful operations return a 2xx code. Client-side errors include 400 (Bad Request), 401 (Unauthorized), 403 (Forbidden), 404 (Not Found), 409 (Conflict), 429 (Too Many Requests), and 499 (Client Closed Request). Server-side errors include 500 (Internal Server Error), 501 (Not Implemented), 503 (Service Unavailable), and 504 (Gateway Timeout). The most specific error code should be returned when multiple codes apply.\n"],null,["# HTTP Status Codes\n\nThe following status codes can be returned in HTTP responses.\n\n| HTTP Code | HTTP Description | Notes |\n|-----------|-----------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| 2xx | OK | Not an error; returned on success. This should also be used for business logic failures (e.g. `booking_failure` in [`CreateBookingResponse`](/actions-center/verticals/local-services/e2e/reference/booking-server-api-rest/e2e-methods/createbooking-method) is populated) |\n| 400 | Bad Request | Bad Request/Invalid Arguments (merchant, service, slot not found, trying to book an invalid slot, cancelling a booking that never existed). |\n| 401 | Unauthorized | Unauthenticated (invalid credentials, retry login). The request does not have valid authentication credentials for the operation. |\n| 403 | Forbidden | Permission denied/forbidden (caller is known and rejected). This response must not be used for rejections caused by exhausting some resource (use `Too Many Requests` instead for those errors). `Forbidden` must not be used if the caller can not be identified (use `Unauthorized` instead for those errors). |\n| 404 | Not Found | Not found (Resource not found, invalid url, including invalid RPCs) |\n| 409 | Conflict | The operation was aborted, typically due to a concurrency issue such as a sequencer check failure or transaction abort. |\n| 429 | Too Many Requests | Some resource has been exhausted, perhaps a per-user quota, or perhaps the entire file system is out of space. |\n| 499 | Client Closed Request | The operation was cancelled, typically by the caller. |\n| 500 | Internal Server Error | Internal errors. This means that some invariants expected by the underlying system have been broken. This error code is reserved for serious errors. |\n| 501 | Not Implemented | The operation is not implemented or is not supported/enabled in this service. |\n| 503 | Service Unavailable | The service is currently unavailable. This is most likely a transient condition, which can be corrected by retrying with a backoff. |\n| 504 | Gateway Timeout | The deadline expired before the operation could complete. For operations that change the state of the system, this error may be returned even if the operation has completed successfully. For example, a successful response from a server could have been delayed long enough for the deadline to expire. |\n\nSometimes multiple error codes may apply. Services should return the most\nspecific error code that applies."]]
