قائمة رموز حالة HTTP

تأتي كل استجابة HTTP مع رمز حالة يشير إلى معلومات رقم واضحة حول كيفية معالجة الطلب

رمز حالة HTTP هو السطر الأول في استجابة HTTP ، التي يتم إرسالها من الخادم إلى العميل.

ستكون هذه القائمة مفيدة إذا كنت تحاول معرفة سبب إرسال الخادم لرمز حالة معين ، ومعرفة ما يعنيه ذلك ، أو إذا كنت تقوم ببناء الخادم وأنت تتصفح بحثًا عن رمز الحالة المثالي للعودة.

يتم التعبير عن أكواد الحالة من خلال أرقام مكونة من 3 أرقام ، بالإضافة إلى وصف موجز.

الرقم الأول من الرقم يحددمجموعة الاستجابة.

هناك 5 مجموعات:

1xx: رد إعلامي - يشير إلى أنه تم استلام الطلب وفهمه
2xx: رد ناجح - يشير إلى أن الإجراء الذي طلبه العميل تم استلامه وفهمه وقبوله
3xx: redirection - يشير إلى أنه يجب على العميل اتخاذ إجراء إضافي لإكمال الطلب
4xx: خطأ في العميل - يشير إلى وجود خطأ ، يبدو أنه قد نتج عن العميل
5xx: خطأ في الخادم - يشير إلى حدوث خطأ على الخادم

في بقية المنشور ، أدرج جميع أكواد الحالة المفيدة.

(لقد أزلت بعض التقنيات الخاصة بالتكنولوجيا ، مثل WebDAV ، وتلك التي نادرًا ما تستخدم)

ردود إعلامية

رمز الحالة	وصف
100 استمر	تلقى الخادم عناوين الطلب ويجب على العميل المتابعة لإرسال نص الطلب (في حالة الطلب الذي يحتاج الجسم إلى الإرسال ، على سبيل المثال ، طلب POST). سيكون إرسال نص طلب كبير إلى الخادم بعد رفض طلب لعناوين غير مناسبة أمرًا غير فعال. لجعل الخادم يتحقق من رؤوس الطلب ، يجب على العميل إرسال توقع: 100 متابعة كرأس في طلبه الأولي واستلام رمز حالة المتابعة 100 ردًا قبل إرسال النص. إذا تلقى العميل رمز خطأ مثل 403 (ممنوع) أو 405 (الطريقة غير مسموح بها) ، فلا يجب عليه إرسال نص الطلب. تشير الاستجابة 417 فشل التوقع إلى أنه يجب تكرار الطلب بدون رأس توقع لأنه يشير إلى أن الخادم لا يدعم التوقعات (هذه هي الحالة ، على سبيل المثال ، خوادم HTTP / 1.0).
101 تبديل البروتوكولات	طلب العميل من الخادم تبديل البروتوكولات ووافق الخادم على القيام بذلك.انظر RFC 7231 # 6.2.2

رمز الحالة

وصف

100 استمر

تلقى الخادم عناوين الطلب ويجب على العميل المتابعة لإرسال نص الطلب (في حالة الطلب الذي يحتاج الجسم إلى الإرسال ، على سبيل المثال ، طلب POST). سيكون إرسال نص طلب كبير إلى الخادم بعد رفض طلب لعناوين غير مناسبة أمرًا غير فعال. لجعل الخادم يتحقق من رؤوس الطلب ، يجب على العميل إرسال توقع: 100 متابعة كرأس في طلبه الأولي واستلام رمز حالة المتابعة 100 ردًا قبل إرسال النص. إذا تلقى العميل رمز خطأ مثل 403 (ممنوع) أو 405 (الطريقة غير مسموح بها) ، فلا يجب عليه إرسال نص الطلب. تشير الاستجابة 417 فشل التوقع إلى أنه يجب تكرار الطلب بدون رأس توقع لأنه يشير إلى أن الخادم لا يدعم التوقعات (هذه هي الحالة ، على سبيل المثال ، خوادم HTTP / 1.0).

101 تبديل البروتوكولات

طلب العميل من الخادم تبديل البروتوكولات ووافق الخادم على القيام بذلك.انظر RFC 7231 # 6.2.2

استجابات ناجحة

رمز الحالة	وصف
200 جيد	هذه هي الاستجابة القياسية لطلبات HTTP الناجحة.
201 تم الإنشاء	عادة ما تكون استجابة لطلب POST. اكتمل الطلب ، وتم إنشاء مورد جديد.
202 مقبولة	تم قبول الطلب للمعالجة. لا يوجد شيء يقال عن المعالجة الفعلية ، ونتائج ذلك ، والتي قد تحدث على خادم منفصل ، أو مجمعة.
203 معلومات غير موثوقة	أرجع الخادم الأصلي 200 ، وقام وكيل التحويل بين العميل والخادم بتغيير الحمولة
204 لا يوجد محتوى	نجح الخادم في معالجة الطلب ، لكنه لا يعرض أي محتوى.
205 إعادة تعيين المحتوى	نجح الخادم في معالجة الطلب ، لكنه لا يعرض أي محتوى. تشبه استجابة 204 ، لكن الخادم يتطلب أن يقوم العميل بإعادة تعيين عرض المستند (يُستخدم لمسح النماذج ، على سبيل المثال)
206 محتوى جزئي	ردًا على أ`Range`الطلب من العميل ، يرسل الخادم استجابة محتوى جزئية.See RFC 7233#4.1

إعادة التوجيه

رمز الحالة	وصف
301 منقول بشكل دائم	يجب توجيه هذا وجميع الطلبات المستقبلية إلى URI المحدد. استخدم فقط مع طلبات GET / HEAD و`308 Permanent Redirect`لجميع الطرق الأخرى.
302 وجدت	يتم نقل المورد مؤقتًا إلى URL المحدد بواسطة`Location`رأس. استخدم فقط مع طلبات GET / HEAD و`307 Temporary Redirect`لجميع الطرق الأخرى.
303 انظر أخرى	بعد طلب POST أو PUT ، يشير إلى رسالة التأكيد في ملف`Location`رأس ، يمكن الوصول إليه باستخدام طلب GET جديد.
304 غير معدل	عندما يستخدم العميل رؤوس الطلب`If-Modified-Since`أو`If-None-Match`، يشير رمز حالة الاستجابة هذا إلى أن المورد لم يتم تعديله.
307 إعادة توجيه مؤقت	مشابهه ل`302`طلب ، إلا أنه لا يسمح بتغيير طريقة HTTP
308 إعادة توجيه دائم	مشابهه ل`301`طلب ، إلا أنه لا يسمح بتغيير طريقة HTTP

أخطاء العميل

رمز الحالة	وصف
400 طلب سىء	نظرًا لحدوث خطأ طلب تم إنشاؤه على العميل ، لا يمكن للخادم معالجة الطلب. يمكن أن تتضمن الأخطاء طلبًا مشوهًا أو حجمًا أكبر من أن تتم معالجته أو أخطاء أخرى.
401 غير مصرح به	يتم إرساله عندما تكون المصادقة مطلوبة وكان العميل غير مخول
403 ممنوع	المورد غير متوفر لأسباب مختلفة. إذا كان السبب هو المصادقة ، تفضل`401 Unauthorized`رمز الحالة.
404 غير موجود	تعذر العثور على المورد المطلوب.
405 طريقة غير مسموح بها	لا يتوفر المورد من خلال طريقة HTTP هذه ، ولكنه قد يكون مع طريقة أخرى.
406 غير مقبول	اجتاز العميل`Accept`مع قيم غير متوافقة مع الخادم.
407 مطلوب مصادقة الوكيل	يوجد بين العميل والخادم وكيل يتطلب المصادقة.
408 طلب المهلة	انتهت مهلة الخادم في انتظار الطلب.
409 نزاع	يشير إلى أنه لا يمكن معالجة الطلب بسبب التعارض في الحالة الحالية للمورد ، مثل تعارض التحرير بين عدة تحديثات متزامنة.
410 ذهب	لم يعد المورد متاحًا ولن يكون متاحًا مرة أخرى. أقوى من 404 ، على سبيل المثال تفسر محركات البحث ذلك على أنه مؤشر لإزالة هذا المورد من فهرسهم.
مطلوب 411 الطول	يحتاج العميل إلى إضافة رأس طول المحتوى إلى الطلب ، وكان ذلك مطلوبًا.
412 فشل الشرط المسبق	يتم إرجاعها إذا أرسل العميل ملف`If-Unmodified-Since`أو`If-None-Match`عنوان الطلب ، ولا يمكن للخادم تلبية هذا الشرط.
413 الحمولة كبيرة جدًا	الطلب أكبر مما يرغب الخادم أو يمكنه معالجته.
414 URI طويل جدًا	كان URI المقدم طويلاً جدًا بحيث يتعذر على الخادم معالجته.
415 نوع وسائط غير مدعوم	يحتوي كيان الطلب على نوع وسائط لا يدعمه الخادم أو المورد.
416 النطاق غير مرضي	طلب العميل جزءًا من الملف باستخدام امتداد`Range`رأس ، لكن الخادم لا يمكنه توفير هذا الجزء
417 فشل التوقع	لا يمكن للخادم تلبية متطلبات`Expect`عنوان الطلب.
421 طلب خاطئ	تم توجيه الطلب إلى خادم غير قادر على تقديم استجابة (على سبيل المثال بسبب إعادة استخدام الاتصال).
426 ترقية مطلوبة	يجب على العميل التبديل إلى بروتوكول مختلف مثل TLS / 1.0 المحدد في`Upgrade`حقل الرأس.
428 شرط مسبق مطلوب	يطلب الخادم أن يحتوي الطلب على ملف`If-Match`رأس.
429 طلبات كثيرة جدًا	أرسل المستخدم عددًا كبيرًا جدًا من الطلبات في فترة زمنية معينة. تستخدم لتحديد السعر.
431 حقول رأس الطلب كبيرة جدًا	لا يمكن تنفيذ الطلب لأن رأسًا واحدًا أو أكثر ، أو مجموعة الرؤوس بأكملها ، كبيرة جدًا.
451 غير متوفر لأسباب قانونية	المورد غير متوفر لأسباب قانونية

أخطاء الخادم

رمز الحالة	وصف
500 خطأ خادم داخلي	رسالة خطأ عامة في الخادم ، يتم تقديمها عند مصادفة حالة غير متوقعة وعدم وجود رسالة أكثر تحديدًا مناسبة.
501 لم يتم التنفيذ	إما أن الخادم لا يتعرف على طريقة الطلب ، أو أنه يفتقر إلى القدرة على تلبية الطلب.
502 مدخل غير صالح	كان الخادم يعمل كبوابة أو وكيل وتلقى استجابة غير صالحة من الخادم الرئيسي.
503 الخدمة غير متوفرة	الخادم غير متاح حاليًا مؤقتًا (بسبب زيادة التحميل عليه أو تعطله للصيانة).
البوابة 504 انتهى الزمن	كان الخادم يعمل كبوابة أو وكيل ولم يتلق استجابة في الوقت المناسب من الخادم الرئيسي.
505 إصدار HTTP غير مدعوم	الخادم لا يدعم إصدار بروتوكول HTTP المحدد في الطلب.