Skip to content

کدهای وضعیت HTTP توضیح داده شده

هر کد وضعیت پاسخ رایج HTTP، گروه‌بندی‌شده بر پایه کلاس: معنای آن و زمانی که با آن روبه‌رو می‌شوید. مرجع سریع همراه ابزار کدهای وضعیت HTTP.

کدهای وضعیت HTTP همگی یک الگو دارند: رقم نخست کلاس را مشخص می‌کند و باقی جزئیات است. 1xx یعنی اطلاع‌رسانی، 2xx یعنی موفقیت، 3xx یعنی تغییر مسیر، 4xx یعنی خطای سمت کلاینت، و 5xx یعنی خرابی سرور. نخست رقم اول را بخوانید. ابزار همراه اجازه می‌دهد تک کد را عمیق‌تر بررسی کنید.

جدول مرجع · 55 موردباز کردن ابزار http-status-codes →
55 of 55 rows
1xx اطلاع‌رسانی
Continueسرور هدرهای درخواست را دریافت کرده و کلاینت می‌تواند بدنه را بفرستد.پس از بررسی پیش‌پرواز، قبل از بارگذاری بدنه بزرگ.
Switching Protocolsسرور با تغییر به پروتکل درخواستیِ کلاینت موافقت می‌کند.ارتقای اتصال HTTP به WebSocket.
Processingسرور درخواست را دریافت کرده و هنوز روی آن کار می‌کند.سرور WebDAV که درخواست طولانی را تأیید می‌کند تا کلاینت تایم‌اوت نشود.
Early Hintsسرور پیش از آماده شدن پاسخ نهایی، هدرهای مقدماتی می‌فرستد.اجازه دادن به مرورگر برای پیش‌بارگذاری منابع، در حالی که صفحه هنوز رندر می‌شود.
2xx موفقیت
OKدرخواست موفق بود و بدنه پاسخ نتیجه را حمل می‌کند.موفقیت استاندارد برای GET یا PUT.
Createdدرخواست موفق بود و یک منبع جدید ساخته شد.برگرداندن پس از یک POST موفق که چیزی می‌سازد.
Acceptedدرخواست برای پردازش پذیرفته شده اما هنوز تمام نشده است.یک کار طولانی شروع شده و به‌صورت ناهمگام اجرا می‌شود.
Non-Authoritative Informationدرخواست موفق بود اما داده برگشتی در مسیر بازگشت دگرگون شده است.پراکسی یا کش که به‌جای فراداده مبدأ، فراداده تغییریافته ارائه می‌کند.
No Contentدرخواست موفق بود و بدنه‌ای برای برگرداندن وجود ندارد.DELETE موفق بود، یا PUT بدون چیزی برای گفتن.
Reset Contentدرخواست موفق بود و کلاینت باید نمای ارسال‌کننده را بازنشانی کند.پس از ارسال فرم، به صفحه می‌گوید فیلدهایش را پاک کند.
Partial Contentسرور طبق درخواست، تنها بخشی از منبع را برمی‌گرداند.ارائه محدوده بایتی از یک درخواست Range.
3xx تغییر مسیر
Moved Permanentlyمنبع URL جدید دائمی دارد و درخواست‌های بعدی باید از آن استفاده کنند.صفحه‌ای جابه‌جا شده و موتورهای جست‌وجو باید نمایه خود را به‌روز کنند.
Foundمنبع موقتاً در URL دیگری است، اما همچنان از URL اصلی استفاده کنید.هدایت موقت به صفحه ورود.
See Otherپاسخ در URL دیگری قرار دارد و باید با GET دریافت شود.الگوی PRG: هدایت POST به صفحه نتیجه تا بازآوری فرم را دوباره ارسال نکند.
Not Modifiedنسخه ذخیره‌شده هنوز معتبر است، پس سرور بدنه‌ای نمی‌فرستد.GET شرطی که کش کلاینت به‌روز است.
Use Proxyدرخواست باید از طریق پراکسی ذکرشده در پاسخ ارسال شود.شبکه‌های پراکسی قدیمی؛ منسوخ از ۲۰۱۱.
Temporary Redirectمنبع موقتاً جای دیگری است و روش درخواست اصلی باید حفظ شود.مانند 302، اما POST در هدایت همان POST می‌ماند.
Permanent Redirectمنبع URL جدید دائمی دارد و روش درخواست اصلی باید حفظ شود.مانند 301، اما POST در هدایت همان POST می‌ماند.
4xx خطای کلاینت
Bad Requestسرور به دلیل نحو معیوب نتوانست درخواست را بفهمد.JSON معیوب، یا فیلد اجباری غایب.
Unauthorizedاحراز هویت لازم است و یا غایب بود یا شکست خورد.نبودن توکن، یا توکن نامعتبر یا منقضی‌شده.
Payment Requiredدرخواست به پرداخت نیاز دارد، هرچند مشخصات هرگز نحوه آن را تعریف نکرد.برخی APIها آن را نشانه دیوار پرداخت می‌دانند؛ بیشترشان هرگز از آن استفاده نمی‌کنند.
Forbiddenکلاینت احراز هویت شده اما اجازه دسترسی به این منبع را ندارد.ورود معتبر، اما بدون مجوز برای این منبع.
Not Foundسرور در این URL منبعی ندارد.URL ناشناخته یا شناسه‌ای که وجود ندارد.
Method Not AllowedURL وجود دارد اما روش درخواست استفاده‌شده را مجاز نمی‌داند.POST به نقطه پایانی که فقط GET می‌پذیرد.
Not Acceptableسرور نمی‌تواند محتوایی مطابق هدرهای Accept کلاینت برگرداند.کلاینت فقط XML خواسته، اما API فقط JSON برمی‌گرداند.
Proxy Authentication Requiredکلاینت باید پیش از ادامه درخواست، نزد پراکسی احراز هویت کند.پراکسی سازمانی که درخواست بدون احراز هویت را رد می‌کند.
Request Timeoutکلاینت برای فرستادن درخواست زیاد وقت گذاشت و سرور دست کشید.بارگذاری‌ای که پیش از رسیدن کامل بدنه متوقف شد.
Conflictدرخواست با وضعیت فعلی منبع در تضاد است.ایمیل تکراری یا مسابقه ویرایش روی یک رکورد.
Goneمنبع روزی وجود داشته اما برای همیشه حذف شده است.نقطه پایانی که عمداً بازنشسته شده، قوی‌تر از 404.
Length Requiredدرخواست به هدر Content-Length نیاز دارد و آن را ندارد.سروری که باید اندازه را از قبل بداند، بدنه جریانی را رد می‌کند.
Precondition Failedیک پیش‌شرط هدر مانند If-Match نادرست ارزیابی شد.ویرایش خوش‌بینانه‌ای که رکورد پس از خواندن کلاینت تغییر کرده است.
Content Too Largeبدنه درخواست از حد پذیرش سرور فراتر می‌رود.بارگذاری‌ای بزرگ‌تر از بیشینه اندازه بدنه سرور.
URI Too LongURL درخواست از آنچه سرور حاضر است تفسیر کند طولانی‌تر است.فرمی که به‌طور تصادفی به رشته پرس‌وجوی GET با رشد بی‌انتها تبدیل شد.
Unsupported Media Typeقالب بدنه درخواست از قالب‌های پذیرفتنی نقطه پایانی نیست.POST با Content-Type text/plain به نقطه پایانی فقط JSON.
Range Not Satisfiableمحدوده بایتی هدر Range با منبع سازگار نیست.درخواست بایت‌های فراتر از انتهای فایل هنگام ازسرگیری دانلود.
Expectation Failedسرور نمی‌تواند انتظار بیان‌شده در هدر Expect را برآورده کند.انتظار 100-continue که سرور از برآوردنش سر باز می‌زند.
I'm a teapotسرور یک قوری چای است و از دم‌کردن قهوه سر باز می‌زند.شوخی روز اول آوریل ۱۹۹۸ که نمی‌میرد؛ APIها برای سرگرمی برمی‌گردانندش.
Misdirected Requestدرخواست به سروری فرستاده شده که نمی‌تواند برای آن پاسخی تولید کند.اتصال بازاستفاده‌شده به میزبانی فرستاده شده که این سرور به آن خدمت نمی‌دهد.
Unprocessable Entityدرخواست خوش‌ساخت است اما مقادیرش از اعتبارسنجی معنایی رد می‌شوند.JSON معتبری که فیلدهایش قواعد کسب‌وکار را نقض می‌کنند.
Too Earlyسرور درخواستی را رد می‌کند که خطر بازپخش دارد.رد درخواست non-idempotentِ بازآزموده پیش از چرخش کلیدها.
Upgrade Requiredکلاینت برای استفاده از این منبع باید به پروتکل دیگری سوئیچ کند.نقطه پایانی که بر TLS یا WebSocket پافشاری می‌کند.
Precondition Requiredسرور به هدرهای شرطی نیاز دارد که درخواست نفرستاده است.APIای که برای جلوگیری از به‌روزرسانی‌های گم‌شده، If-Match می‌خواهد.
Too Many Requestsکلاینت در بازه زمانی معین درخواست‌های زیادی فرستاده است.برخورد با محدودیت نرخ؛ کمی صبر کنید و دوباره تلاش کنید.
Request Header Fields Too Largeیک یا چند فیلد هدر برای پردازش سرور بیش از حد بزرگ‌اند.کوکی یا توکنی که آن‌قدر بزرگ شد تا هر درخواست به سایت را مسدود کند.
Unavailable For Legal Reasonsمنبع به دلایل قانونی مسدود شده، مانند حذف قانونی یا محدودیت جغرافیایی.حذف قانونی دولتی یا صفحه‌ای که در یک کشور مسدود شده است.
5xx خطای سرور
Internal Server Errorسرور به وضعیت غیرمنتظره‌ای برخورد و شکست خورد.استثنای مدیریت‌نشده یا باگ در سرور.
Not Implementedسرور روش یا قابلیت درخواست‌شده را پشتیبانی نمی‌کند.نقطه پایانی که اعلام شده اما هنوز ساخته نشده است.
Bad Gatewayدروازه یا پراکسی از سرور بالادستی پاسخ نامعتبر دریافت کرد.پراکسی معکوس که نتوانست به بک‌اند برسد.
Service Unavailableسرور به‌طور موقت قادر به رسیدگی به درخواست نیست.نگهداری، بار بیش از حد، یا از دسترس خارج بودن سرویس وابسته.
Gateway Timeoutدروازه یا پراکسی در زمان مقرر از سرور بالادستی پاسخی نگرفت.بک‌اند زیادی طول کشید و پراکسی دست کشید.
HTTP Version Not Supportedسرور نسخه HTTP درخواست را پشتیبانی نمی‌کند.کلاینتی که نسخه‌ای از پروتکل را صحبت می‌کند که سرور هرگز نیاموخته است.
Variant Also Negotiatesمذاکره محتوای شفاف به ارجاع دوری انجامید.سرور بدپیکربندی‌شده که مذاکره محتوای آزمایشی انجام می‌دهد.
Insufficient Storageسرور نمی‌تواند بازنمایی لازم برای کامل کردن درخواست را ذخیره کند.سرور WebDAV که فضای ذخیره‌سازی اختصاص‌یافته‌اش پر شده است.
Loop Detectedسرور هنگام پردازش درخواست به حلقه بی‌پایان رسید.پیوند WebDAV که به خودش ارجاع می‌دهد.
Network Authentication Requiredکلاینت برای به‌دست آوردن دسترسی باید نزد شبکه احراز هویت کند.پرتال مقید در هتل یا فرودگاه که درخواست را رهگیری می‌کند.