رموز الاستجابة للحالة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يمكن عرض رموز الحالة التالية في استجابات HTTP.
رمز HTTP |
وصف HTTP |
ملاحظات |
2xx |
حسنًا |
ليس خطأ، بل يتم إرجاعه عند النجاح. يجب أيضًا استخدام هذا الإجراء في حالات تعذُّر منطق النشاط التجاري
(مثل تعبئة booking_failure في
CreateBookingResponse
). |
400 |
طلب سيئ |
طلب غير صالح/وسائط غير صالحة (تعذّر العثور على التاجر أو الخدمة أو خانة الحجز،
محاولة حجز خانة حجز غير صالحة، إلغاء حجز لم يكن
موجودًا) |
401 |
غير مخول |
لم يتم إثبات الهوية (بيانات الاعتماد غير صالحة، يُرجى إعادة محاولة تسجيل الدخول). لا يحتوي الطلب
على بيانات اعتماد مصادقة صالحة للعملية. |
403 |
ممنوع |
تم رفض الإذن/محظور (المتصل معروف وتم رفضه). يجب عدم استخدام
هذا الردّ في حالات الرفض الناتجة عن استنفاد بعض موارد
الجهاز (استخدِم Too Many Requests بدلاً من ذلك لهذه الأخطاء).
يجب عدم استخدام Forbidden إذا تعذّر تحديد هوية المتصل (استخدِم Unauthorized بدلاً من ذلك لهذه الأخطاء). |
404 |
غير موجود |
لم يتم العثور عليه (لم يتم العثور على المورد، عنوان URL غير صالح، بما في ذلك طلبات RPC غير الصالحة) |
409 |
الحبكة |
تم إلغاء العملية، عادةً بسبب مشكلة في التوافق، مثل
تعذُّر التحقّق من التسلسل أو إلغاء المعاملة. |
429 |
عدد كبير جدًا من الطلبات |
تم استنفاد بعض الموارد، ربما حصة لكل مستخدم، أو ربما
لم يعد هناك مساحة في نظام الملفات بأكمله. |
499 |
طلب العميل المغلق |
تم إلغاء العملية، عادةً من قِبل المتصل. |
500 |
خطأ في الخادم الداخلي |
الأخطاء الداخلية وهذا يعني أنّه تمّ انتهاك بعض الشروط الثابتة التي يتوقعها
النظام الأساسي. رمز الخطأ هذا مخصّص لتسجيل
الأخطاء الخطيرة. |
501 |
لم يتم التنفيذ |
لم يتم تنفيذ العملية أو أنها غير متاحة أو مفعَّلة في هذه
الخدمة. |
503 |
الخدمة غير متوفرة |
هذه الخدمة غير متاحة حاليًا. من المرجّح أنّ هذا الموقف هو حالة عابر
يمكن تصحيحها من خلال إعادة المحاولة مع فترة انتظار. |
504 |
انتهت مهلة المدخل |
انتهت المهلة قبل اكتمال العملية. بالنسبة إلى
العمليات التي تغيّر حالة النظام، قد يتم
عرض هذا الخطأ حتى إذا اكتملت العملية بنجاح. على سبيل المثال،
قد يكون قد تأخّر وصول استجابة ناجحة من خادم لفترة طويلة
بما يكفي لانتهاء المهلة. |
في بعض الأحيان، قد تنطبق رموز أخطاء متعددة. يجب أن تعرض الخدمات رمز الخطأ
الأكثر تحديدًا الذي ينطبق.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-26 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\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 used.\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 are 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,["# Status Response 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/reservations/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."]]