يحتفظ كل مطور بقائمة مختصرة ذهنية لرموز حالة HTTP. كان جهازي 200 و404 و500، وكان ذلك كافيًا لفترة طويلة لتزييف الكفاءة. ثم أمضيت أسبوعًا في بناء تكامل دفع حيث أعادت واجهة برمجة التطبيقات 402 للبطاقة المرفوضة، و409 عندما أعدت تجربة الرسوم التي تم تحصيلها بالفعل، و429 عندما توصلت اختباراتي إلى ذلك بسرعة كبيرة. وفجأة أصبح الفرق بين الرموز هو الفرق بين ميزة العمل وتذكرة الدعم. أقوم ببناء الكثير من أدوات الويب لـ تولز.ديفومرجع رمز الحالة القابل للبحث هو أحد الأشياء التي أصل إليها باستمرار، لذلك قمت ببناء واحد في الموقع وكتبت هذا الدليل ليتوافق معه.
ليرة تركية؛DR: رمز حالة HTTP هو رقم مكون من ثلاثة أرقام يرسله الخادم مرة أخرى لوصف نتيجة الطلب. يقوم الرقم الأول بتعيين الفئة: معلومات 1xx، نجاح 2xx، إعادة توجيه 3xx، خطأ عميل 4xx، خطأ خادم 5xx. ابحث عن أي منهم على الفور باستخدام أداة رموز حالة HTTP، والذي يتيح لك البحث حسب الرقم أو الاسم أو الكلمة الرئيسية ويستشهد بـ RFC الذي يحدد كل منها.
يتتبع هذا الدليل رموز الحالة، وما تعنيه كل فئة، والرموز المحددة التي تستحق الحفظ، والرموز التي يخطئ فيها الأشخاص في أغلب الأحيان. إنه يهدف إلى قيام مطوري الواجهة الأمامية بتصحيح أخطاء مكالمات واجهة برمجة التطبيقات، ومطورو الواجهة الخلفية الذين يقررون ما يجب إرجاعه، وأي شخص يقوم بتحسين محركات البحث الفنية ويحتاج إلى عمليات إعادة التوجيه للتصرف.
ما هو رمز حالة HTTP؟
في كل مرة يطلب فيها متصفحك أو تطبيق ما شيئًا ما عبر الويب، يجيب الخادم بإجابة. يحتوي السطر الأول من تلك الاستجابة على رمز الحالة: رقم مكون من ثلاثة أرقام، مقترنًا بعبارة سبب قصيرة مثل "؛OK"؛ أو "؛ لم يتم العثور عليه واقتباسه؛. الكود هو ملخص يمكن قراءته آليًا لما حدث، وعبارة السبب هي الملصق المناسب للإنسان. يتصرف العملاء على الرقم؛ العبارة مخصصة للأشخاص الذين يقرؤون السجلات.
يتم تعريف رموز الحالة بواسطة فريق عمل هندسة الإنترنت، بشكل أساسي في RFC 9110، الذي قام بتوحيد مواصفات HTTP الأقدم في عام 2022. يسرد السجل المركزي الذي تحتفظ به IANA كل رمز معترف به رسميًا. هذا التوحيد هو ما يتيح للمتصفح الذي كتبته إحدى الشركات التحدث إلى خادم كتبته شركة أخرى والاتفاق على ما يعنيه 404. أداة رموز حالة HTTP يعكس هذا السجل، حيث يسرد كل رمز قياسي بمعناه وRFC الذي يحدده.
النموذج العقلي الرئيسي هو أن الرقم الأول يخبرك بالفئة، والفئة تخبرك من المسؤول. رمز 4xx يعني أن العميل أرسل شيئًا خاطئًا. رمز 5xx يعني فشل الخادم بناءً على طلب كان جيدًا. يعمل هذا التمييز الفردي على حل معظم وسيطات تصحيح الأخطاء حول الخطأ الذي يحدثه.
ماذا تعني فئات رمز الحالة الخمس؟
هناك بالضبط خمس فئات، مجمعة حسب الرقم الرئيسي. يعد فهم الفصل أكثر قيمة من حفظ الرموز الفردية، لأنه يخبرك بمكان البحث.
فئة 1xx إعلامية. تشير هذه الرموز إلى أن الخادم تلقى الطلب وتستمر المعالجة. وهي نادرة في العمل اليومي. أشهرها هو 100 متابعة، والأكثر فائدة هو 103 تلميحات مبكرة، والتي تتيح للخادم إخبار المتصفح ببدء التحميل المسبق للموارد قبل أن تصبح الاستجابة الكاملة جاهزة.
فئة 2xx تعني النجاح. تم استلام الطلب وفهمه وقبوله. 200 موافق هو رمز النجاح اليومي، 201 تم الإنشاء يؤكد إنشاء مورد جديد، و204 لا يوجد محتوى يقول "؛ تم، لا يوجد شيء لإرساله مرة أخرى "؛ وهو أمر شائع لعمليات الحذف.
فئة 3xx هي إعادة التوجيه. يعيش المورد في مكان آخر، أو لم يتغير منذ آخر مرة رآه العميل. هذه الفئة هي المكان الذي يعيش فيه تحسين محركات البحث، لأن 301 و302 يخبران محركات البحث ما إذا كانت الخطوة دائمة. 304 غير معدل هو العمود الفقري للتخزين المؤقت الذي يوفر نطاقًا تردديًا هائلاً.
فئة 4xx هي خطأ العميل. كان الطلب مشوهًا أو غير مصرح به أو يشير إلى شيء غير موجود. 400، 401، 403، 404، و429 كلها موجودة هنا. عندما ترى 4xx، تحقق من التعليمات البرمجية التي أرسلتها قبل إلقاء اللوم على الخادم.
فئة 5xx هي خطأ في الخادم. كان الطلب صالحًا ولكن الخادم لم يتمكن من الوفاء به. 500 و502 و503 و504 هي العناصر التي ستقابلها في حوادث الإنتاج، وعادةً ما تشير إلى عطل أو خدمة محملة بشكل زائد أو تبعية أولية مكسورة.
ما هي رموز حالة HTTP التي يجب أن يعرفها كل مطور؟
لا تحتاج إلى أكثر من ستين رمزًا في رأسك. ربما تحتاج إلى خمسة عشر، والباقي تبحث عنه. هنا مجموعة العمل التي أعتقد أنها تكسب مكانًا دائمًا في الذاكرة، مع المواقف التي تثيرها.
| شفرة | معنى | عندما تراه |
|---|---|---|
| 200 | نعم | طلب ناجح عادي |
| 201 | مخلوق | قام POST أو PUT بإنشاء مورد جديد |
| 204 | لا محتوى | النجاح بجسم فارغ، شائع بعد الحذف |
| 301 | انتقلت بشكل دائم | تم نقل عنوان URL إلى الأبد؛ عمليات نقل تصنيف تحسين محركات البحث |
| 302 | وجد | إعادة توجيه مؤقتة؛ استمر في استخدام عنوان URL القديم |
| 304 | غير معدل | النسخة المخزنة مؤقتًا لا تزال صالحة؛ لم يتم إرسال أي شخص |
| 400 | طلب سيء | بناء جملة مشوه أو تأطير طلب غير صالح |
| 401 | غير مصرح | المصادقة مفقودة أو فاشلة |
| 403 | ممنوع | مصادق عليها ولكن غير مسموح بها |
| 404 | لم يتم العثور عليه | المورد غير موجود |
| 409 | صراع | الطلب يتعارض مع الوضع الحالي |
| 422 | محتوى غير قابل للمعالجة | بناء جملة صالح، وقواعد التحقق الفاشلة |
| 429 | طلبات كثيرة جدًا | السعر محدود؛ التراجع وإعادة المحاولة |
| 500 | خطأ في الخادم الداخلي | فشل غير متوقع في الخادم |
| 503 | الخدمة غير متوفرة | الخادم مثقل أو قيد الصيانة |
أما باقي السجل، من 226 IM Used إلى 451 Unavailable For Legal Reasons، فهو يستحق التقدير ولكن لا يستحق الحفظ. هذا هو بالضبط الغرض من أداة البحث.
ما الفرق بين 401 و 403؟
يقوم هذا الزوج بتعثر الجميع تقريبًا، لذا فهو يستحق قسمًا خاصًا به. كلاهما يعني رفض الوصول، ولكن لأسباب مختلفة، والفرق يغير كيفية استجابة تطبيقك.
401 غير مصرح به يعني أن الطلب يفتقر إلى المصادقة الصالحة. الخادم لا يعرف من أنت. إما أنك لم ترسل أي بيانات اعتماد، أو أن البيانات التي أرسلتها كانت خاطئة أو منتهية الصلاحية. الاستجابة الصحيحة من جانبك هي تسجيل الدخول أو تحديث الرمز المميز. حسب المواصفات، يجب أن تتضمن الاستجابة 401 رأس مصادقة WWW لإخبار العميل بكيفية المصادقة.
403 ممنوع يعني أن الخادم يعرف بالضبط من أنت ويرفض على أي حال. لقد تمت مصادقتك ولكنك غير مصرح لك بهذا المورد المحدد. لن يساعد تسجيل الدخول مرة أخرى، لأن المشكلة تكمن في الأذونات، وليس الهوية. يجب أن يحصل المستخدم العادي الذي يصل إلى نقطة نهاية المسؤول فقط على 403.
القاعدة السريعة التي أستخدمها: 401 هي "؛ من أنت؟"؛ 403 هو "؛ أعرف من أنت، ولا "؛. إذا كنت تقوم بإنشاء واجهة برمجة تطبيقات وتريد إنشاء رؤوس التفويض لاختبار هذه التدفقات، فإن مولد المصادقة الأساسي ينتج بيانات الاعتماد المشفرة التي تحتاجها.
لماذا تعتبر عمليات إعادة التوجيه 301 مقابل 302 مهمة لتحسين محركات البحث؟
عمليات إعادة التوجيه هي حيث تتوقف رموز الحالة عن كونها تفاصيل تنفيذ داخلية وتبدأ في التأثير على تصنيفات البحث الخاصة بك. عند نقل صفحة، يخبر رمز الحالة الذي تقوم بإرجاعه محركات البحث بما يجب فعله باستخدام السلطة المتراكمة القديمة لـ URL'؛s.
يشير 301 Moved بشكل دائم إلى أن هذه الخطوة نهائية. تقوم محركات البحث بإسقاط عنوان URL القديم من فهرسها بمرور الوقت، وتمرير إشارات التصنيف إلى عنوان URL الجديد، وتحديث روابطها. هذا هو الرمز الذي تريده عند إعادة تسمية صفحة، أو الترحيل إلى HTTPS، أو دمج عناوين URL المكررة. يعد استخدامه بشكل صحيح أحد الإصلاحات الأكثر شيوعًا في التدقيق الفني لتحسين محركات البحث.
يشير العثور على 302 إلى خطوة مؤقتة. تحتفظ محركات البحث بعنوان URL الأصلي مفهرسًا لأنك أخبرتهم أن التغيير ليس دائمًا. إذا كنت تستخدم 302 لنقل دائم، فيمكنك تحديد ترتيبك على عنوان URL لم تعد تستخدمه. لقد رأيت المواقع تفقد الرؤية لعدة أشهر بسبب افتراضية إطار العمل على 302 عملية إعادة توجيه أثناء ترحيل HTTPS.
هناك أيضًا 307 إعادة توجيه مؤقتة و308 إعادة توجيه دائمة، والتي تتصرف مثل 302 و301 ولكنها تضمن الحفاظ على طريقة HTTP ونصها. استخدم 307 و308 للطلبات غير المتعلقة بـ GET حيث يؤدي تغيير الطريقة إلى كسر الأشياء. إذا كنت تقوم بمراجعة كيفية رؤية برامج الزحف لموقعك، فقم بإقران هذه المعرفة بـ مولد robots.txt و ال مولد العلامات للتأكد من أن صورة الزحف وإعادة التوجيه بأكملها متسقة. ال مجموعة أدوات مطور الويب دليل يربط هذه القطع معا.
ما هي رموز أخطاء الخادم الأكثر شيوعًا وكيف تقوم بتصحيح أخطائها؟
فئة 5xx هي المكان الذي تعيش فيه حوادث الإنتاج، وكل رمز يوجهك إلى طبقة مختلفة من المكدس. معرفة أيهما يوفر الوقت الفعلي أثناء انقطاع الخدمة.
خطأ الخادم الداخلي 500 هو الشامل العام. وهذا يعني أن رمز التطبيق الخاص بك ألقى استثناءً لم تتم معالجته أو وصل إلى حالة لا يمكنه معالجتها. الإصلاح يكون دائمًا تقريبًا في سجلاتك الخاصة. الرقم 500 هو الخادم الذي يقول "؛ حدث ما انكسر وليس لدي كلمة أفضل عنه؛ لذلك يخبرك الكود بمكان البحث ولكن ليس بالخطأ الذي حدث.
يأتي كل من 502 Bad Gateway و504 Gateway Timeout من خادم يعمل كبوابة أو وكيل، مثل موازن التحميل أو الوكيل العكسي أمام تطبيقك. 502 يعني أن المنبع أرسل شيئًا غير صالح، غالبًا بسبب تعطل تطبيقك أو عدم تشغيله. 504 يعني أن المنبع استغرق وقتًا طويلاً للرد وتوقفت البوابة عن الانتظار. إذا ركضت خلف Nginx أو CDN أو موازن التحميل السحابي، فهذه هي الرموز التي ستراها عندما يكون الشيء الموجود خلف الوكيل غير صحي.
خدمة 503 غير متوفرة تعني أن الخادم غير قادر مؤقتًا على التعامل مع الطلب، عادةً بسبب التحميل الزائد أو أثناء الصيانة. تتضمن استجابات 503 حسنة التصرف رأس إعادة المحاولة بعد إخبار العملاء بموعد العودة. يعد إرسال 503 أثناء الصيانة المخطط لها هو الطريقة الصحيحة والآمنة لتحسين محركات البحث لإزالة الموقع لفترة وجيزة، لأنه يخبر محركات البحث بالعودة لاحقًا بدلاً من افتراض اختفاء الصفحات. لإلقاء نظرة أوسع على تشخيص مشكلات الويب، فإن أدوات إنتاجية المطور يغطي الدليل مجموعة الأدوات الأوسع.
ماذا عن رموز الحالة الأقل شيوعًا؟
خارج مجموعة العمل، يحمل السجل مجموعة طويلة من الرموز التي ستقابلها من حين لآخر، والتعرف عليها يوفر نصف ساعة مشوشة. القليل منها يستحق جولة سريعة.
في عائلة 2xx، يعمل المحتوى الجزئي 206 على تشغيل التنزيلات القابلة للاستئناف وتدفق الفيديو. عندما يرسل العميل رأس نطاق يطلب بايتات من 500 إلى 999 من الملف، يجيب الخادم على 206 بهذه الشريحة فقط. هذه هي الطريقة التي يتم بها استئناف التنزيل المتوقف مؤقتًا بدلاً من البدء من جديد، وكيف يسعى المتصفح إلى منتصف الفيديو دون جلب كل شيء أولاً.
في عائلة 4xx، 410 Gone هو إصدار أقوى وأكثر تعمدًا من 404. حيث يقول 404 "؛ لم أتمكن من العثور عليه واقتباسه؛ 410 يقول "؛ لقد كان هنا، لقد اختفى نهائيًا، توقف عن السؤال والاقتباس؛. استخدام 410 للمحتوى الذي قمت بإزالته عمدًا يساعد محركات البحث على إسقاطه بشكل أسرع من 404. هناك رقم آخر مفيد وهو 451 غير متاح لأسباب قانونية، ورقمه إشارة إلى رواية فهرنهايت 451، والذي يتم إرجاعه عندما يتم حظر المحتوى بموجب أمر قانوني مثل الإزالة أو أمر قضائي.
هناك أيضًا 418 I'؛ إبريق شاي، وهو رمز مسجل حقيقي من مواصفات كذبة أبريل لعام 1998 التي يعود بها إبريق الشاي عندما يُطلب منه تحضير القهوة. لا يتم استخدامه لحركة المرور العادية، ولكنه يظهر كبيضة عيد الفصح في بعض واجهات برمجة التطبيقات، وهو تذكير صغير بأن الأشخاص الذين كتبوا هذه المعايير يتمتعون بروح الدعابة. تسرد الأداة كل هذه الأشياء حتى تتمكن من البحث عن أي شيء تتعثر فيه دون تخمين.
كيف تساعد أداة رموز حالة HTTP؟
الأداة بسيطة عن عمد، لأن المهمة بسيطة: لديك رمز أو عرض، وتريد المعنى بسرعة. يمكنك البحث حسب الرقم، أو حسب عبارة السبب مثل "؛ لم يتم العثور عليه واقتباسه؛ أو عن طريق كلمة رئيسية من الوصف مثل "؛ إعادة التوجيه والاقتباس؛ أو "؛ حد المعدل والاقتباس؛. يمكنك التصفية إلى فئة واحدة لتصفح عمليات إعادة التوجيه فقط أو أخطاء الخادم فقط. يعرض كل إدخال عبارة السبب، وشرحًا واضحًا لموعد تطبيق الكود، وRFC الذي يحدده، حتى تتمكن من تأكيد السلوك ضد المصدر الأساسي.
نظرًا لأن السجل بأكمله يتم تحميله في متصفحك، فإن البحث يكون فوريًا ويعمل دون اتصال بالإنترنت بمجرد فتح الصفحة. لا يتم إرسال أي شيء تبحث عنه إلى أي مكان. إنه نوع المرجع الذي أحتفظ به مثبتًا في علامة تبويب أثناء إنشاء واجهة برمجة التطبيقات، بجوار محلل وكيل المستخدم لفحص رؤوس الطلب.
الأسئلة المتداولة
ما هي الفئات الخمس لرموز حالة HTTP؟
يتم تجميع رموز حالة HTTP حسب الرقم الأول: معلومات 1xx، نجاح 2xx، إعادة توجيه 3xx، خطأ عميل 4xx، وخطأ خادم 5xx. يخبرك الفصل في لمحة عما إذا كان الطلب قد نجح أو تمت إعادة توجيهه أو فشل من جانب العميل أو الخادم، وهو ما يكفي عادةً لمعرفة مكان بدء تصحيح الأخطاء.
ماذا يعني رمز الحالة 404؟
عدم العثور على 404 يعني أن الخادم لم يتمكن من العثور على المورد المطلوب. قد يكون عنوان URL به خطأ إملائي، أو ربما تم حذف الصفحة، أو قد يكون الرابط معطلاً. إنه رمز خطأ العميل، لذلك وصل الطلب إلى الخادم ولكنه أشار إلى شيء غير موجود هناك.
ما الفرق بين 301 و 302 إعادة التوجيه؟
يخبر A 301 Moved العملاء ومحركات البحث بشكل دائم أن المورد قد انتقل إلى الأبد، لذلك يقومون بتحديث روابطهم ونقل إشارات التصنيف إلى عنوان URL الجديد. يعد العثور على 302 بمثابة إعادة توجيه مؤقتة، لذا يجب الاستمرار في استخدام عنوان URL الأصلي للطلبات المستقبلية وتبقيه محركات البحث مفهرسًا.
ماذا يعني خطأ الخادم الداخلي 500؟
خطأ الخادم الداخلي 500 هو رسالة عامة تعني أن الخادم وصل إلى حالة غير متوقعة ولم يتمكن من التعامل معها. فهو يشير إلى وجود مشكلة على الخادم بدلاً من الطلب، لذلك يكون الإصلاح عادةً في رمز التطبيق أو التكوين، وتكون سجلات الخادم الخاصة بك هي المكان المناسب للبحث.
متى يجب أن تُرجع واجهة برمجة التطبيقات 400 مقابل 422؟
إرجاع 400 طلب سيئ عندما يكون الطلب نفسه تالفًا، مثل JSON غير صالح أو رأس مطلوب مفقود. إرجاع 422 محتوى غير قابل للمعالجة عندما يكون بناء الجملة صالحًا ولكن البيانات تفشل في قواعد العمل أو التحقق من الصحة، مثل البريد الإلكتروني الذي تم أخذه بالفعل أو قيمة خارج النطاق.
ما هو رمز 429 الكثير من الطلبات؟
يعني 429 طلبًا كبيرًا جدًا أن العميل قد أرسل عددًا كبيرًا جدًا من الطلبات في وقت قصير وأن سعره محدود. غالبًا ما تتضمن الاستجابة رأس إعادة المحاولة بعد إخبار العميل بالمدة التي يجب الانتظار فيها قبل المحاولة مرة أخرى، ويحترمها العملاء ذوو السلوك الجيد من خلال التراجع الأسي.
هل مرجع رمز حالة HTTP مجاني للاستخدام؟
نعم. الأداة مجانية تمامًا بدون تسجيل ولا حدود، وتعمل دون اتصال بالإنترنت بمجرد تحميل الصفحة لأن القائمة بأكملها تعمل في متصفحك. لا يتم إرسال أي شيء تبحث عنه إلى الخادم، لذا فهو آمن وسريع الاستخدام أثناء تصحيح الأخطاء.
