کدهای وضعیت HTTP به ما اطلاعاتی درباره‌ی وضعیت درخواست ارسالی می‌دهند. این کدها معمولاً به صورت عددی سه رقمی هستند و در خط وضعیت پاسخ HTTP (مثلاً HTTP/1.1 200 OK) قرار دارند.
کدهای وضعیت HTTP به پنج دسته تقسیم می‌شوند:
کدهای وضعیت 2xx: موفقیت (Success)
این کدها نشان می‌دهند که درخواست با موفقیت انجام شده است.
کدهای مهم در این گروه:
-
200 OK
-
معنی: درخواست با موفقیت انجام شده است و پاسخ در بدنه آمده است.
-
مثال: درخواست GET برای یک صفحه وب موفقیت‌آمیز است.
-
-
201 Created
-
معنی: درخواست موفقیت‌آمیز بود و منبع جدیدی ایجاد شد (برای متدهای POST و PUT).
-
مثال: پس از ارسال یک فرم برای ایجاد یک کاربر جدید.
-
-
204 No Content
-
معنی: درخواست موفقیت‌آمیز بود اما بدنه‌ی پاسخ خالی است (معمولاً برای درخواست‌های DELETE یا PUT).
-
مثال: پس از حذف یک منبع، پاسخ بدون محتوای اضافی می‌آید.
-
کدهای وضعیت 3xx: تغییر مسیر (Redirection)
این کدها نشان می‌دهند که درخواست باید به یک آدرس جدید هدایت شود.
کدهای مهم در این گروه:
-
301 Moved Permanently
-
معنی: منبع به‌طور دائم به آدرس جدید منتقل شده است.
-
مثال: انتقال دائم یک وب‌سایت از HTTP به HTTPS.
-
-
302 Found (Moved Temporarily)
-
معنی: منبع به‌طور موقت به آدرس جدید منتقل شده است.
-
مثال: تغییر موقت URL یک صفحه به دلیل تعمیرات.
-
-
304 Not Modified
-
معنی: منبع تغییر نکرده است و نیازی به ارسال مجدد محتوا نیست.
-
مثال: در پاسخ به یک درخواست
GETبا هدرهای کش.
-
کدهای وضعیت 4xx: خطای کلاینت (Client Error)
این کدها نشان می‌دهند که درخواست ارسالی توسط کلاینت دارای مشکل است و باید اصلاح شود.
کدهای مهم در این گروه:
-
400 Bad Request
-
معنی: درخواست فرستاده شده به سرور از نظر ساختار یا محتوای اشتباه است.
-
مثال: درخواست حاوی سینتکس نادرست یا پارامترهای نامعتبر.
-
-
401 Unauthorized
-
معنی: برای دسترسی به منبع باید احراز هویت انجام شود.
-
مثال: کاربر باید وارد حساب کاربری خود شود تا به صفحه دسترسی پیدا کند.
-
-
403 Forbidden
-
معنی: دسترسی به منبع مجاز نیست، حتی با احراز هویت.
-
مثال: کاربری که مجاز به دسترسی به منابع خاص نیست.
-
-
404 Not Found
-
معنی: سرور منبع درخواست‌شده را پیدا نکرده است.
-
مثال: تلاش برای دسترسی به یک صفحه وب که حذف شده است.
-
-
405 Method Not Allowed
-
معنی: متد HTTP درخواست‌شده برای این منبع مجاز نیست.
-
مثال: ارسال درخواست
POSTبه یک منبع که فقطGETپشتیبانی می‌کند.
-
کدهای وضعیت 5xx: خطای سرور (Server Error)
این کدها نشان می‌دهند که مشکلی در سرور وجود دارد که باعث عدم توانایی در پردازش درخواست می‌شود.
کدهای مهم در این گروه:
-
500 Internal Server Error
-
معنی: مشکلی داخلی در سرور رخ داده که درخواست نمی‌تواند پردازش شود.
-
مثال: اشکال در کد سرور یا پایگاه داده.
-
-
502 Bad Gateway
-
معنی: سرور به عنوان یک دروازه یا پروکسی پاسخ نامعتبر از سرور دیگر دریافت کرده است.
-
مثال: زمانی که سرور دروازه‌ای درخواست را به یک سرور دیگر ارسال کرده و پاسخ نادرست دریافت کرده باشد.
-
-
503 Service Unavailable
-
معنی: سرور در حال حاضر قادر به پردازش درخواست‌ها نیست (ممکن است به دلیل بار زیاد یا نگهداری سرور باشد).
-
مثال: سرور در حال تعمیر یا به‌روز‌رسانی است.
-
جمع‌بندی
-
کدهای 2xx نشان‌دهنده‌ی موفقیت‌آمیز بودن درخواست‌ها هستند.
-
کدهای 3xx به تغییر مسیر منبع اشاره دارند.
-
کدهای 4xx نشان‌دهنده‌ی خطاهای ناشی از کلاینت هستند.
-
کدهای 5xx بیانگر خطاهای سرور هستند که مانع از پردازش درخواست می‌شوند.
این کدها به کمک توسعه‌دهندگان و کاربران در شناسایی و رفع مشکلات در درخواست‌ها و پاسخ‌ها کمک می‌کنند.