برایم یک قهوه بخرید
توسعه

کدهای وضعیت HTTP

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

نمایش 50 از 50 کد وضعیت
100
ادامه
1xx

کلاینت باید درخواست را ادامه دهد. برای اطلاع‌دادن به کلاینت استفاده می‌شود که بخش ابتدایی درخواست دریافت شده است.

کاربرد: سرور دریافت بخشی از درخواست را تأیید می‌کند؛ کلاینت باید ادامه دهد.
101
تعویض پروتکل
1xx

سرور طبق درخواست کلاینت در حال تغییر به پروتکل دیگری است.

کاربرد: ارتقای HTTP به WebSocket در مرحله دست‌دادن.
102
در حال پردازش
1xx

سرور درخواست را دریافت کرده و در حال پردازش آن است، اما هنوز پاسخی در دسترس نیست.

کاربرد: جلوگیری از اتمام زمان در درخواست‌های طولانی WebDAV.
103
راهنمای زودهنگام
1xx

برای بازگرداندن بخشی از هدرهای پاسخ پیش از پیام نهایی HTTP استفاده می‌شود.

کاربرد: پیش‌بارگذاری منابع پیش از آماده‌شدن پاسخ کامل.
200
موفق
2xx

درخواست موفق بود. معنای دقیق آن به متد HTTP استفاده‌شده بستگی دارد.

کاربرد: پاسخ استاندارد برای GET، POST، PUT و DELETE موفق.
201
ایجاد شد
2xx

درخواست موفق بود و در نتیجه آن یک منبع جدید ساخته شد.

کاربرد: درخواست POST که با موفقیت کاربر یا رکورد جدیدی ساخته است.
202
پذیرفته شد
2xx

درخواست دریافت شده اما هنوز اجرا نشده است. پردازش به‌صورت ناهم‌زمان انجام می‌شود.

کاربرد: اجرای یک کار پس‌زمینه یا وظیفه ناهم‌زمان از طریق API.
203
اطلاعات غیرمرجع
2xx

فراداده بازگردانده‌شده از سرور مبدأ نیست، بلکه از یک نسخه محلی یا شخص ثالث می‌آید.

کاربرد: سرورهای پراکسی که پاسخ‌ها را تغییر می‌دهند یا کش می‌کنند.
204
بدون محتوا
2xx

درخواست موفق بود اما محتوایی برای ارسال در پاسخ وجود ندارد.

کاربرد: درخواست DELETE یا PUT که نیازی به بازگرداندن داده ندارد.
206
محتوای جزئی
2xx

سرور به دلیل هدر range ارسال‌شده از سوی کلاینت، تنها بخشی از منبع را تحویل می‌دهد.

کاربرد: پخش ویدیو یا دانلود فایل با قابلیت ازسرگیری.
207
چندوضعیتی
2xx

چند کد وضعیت برای چند زیردرخواست در WebDAV.

کاربرد: پاسخ‌های PROPFIND در WebDAV با وضعیت چند منبع.
208
قبلاً گزارش شده
2xx

اعضای یک اتصال DAV پیش‌تر در پاسخی قبلی فهرست شده‌اند.

کاربرد: پاسخ‌های WebDAV که از تکرار اعضا جلوگیری می‌کنند.
226
IM استفاده شد
2xx

سرور یک درخواست GET را انجام داده و پاسخ حاصل دستکاری‌های نمونه است.

کاربرد: کدگذاری تفاضلی در پاسخ‌های HTTP.
301
انتقال دائمی
3xx

آدرس URL منبع درخواست‌شده به‌طور دائم تغییر کرده است. آدرس جدید در پاسخ داده می‌شود.

کاربرد: تغییر مسیر دائمی و سازگار با سئو از URL قدیمی به URL جدید.
302
یافت شد
3xx

آدرس URL منبع درخواست‌شده به‌طور موقت تغییر کرده است. ممکن است تغییرات بیشتری رخ دهد.

کاربرد: تغییر مسیر موقت در زمانی که صفحه‌ای در حال به‌روزرسانی است.
303
به مورد دیگر مراجعه کنید
3xx

سرور این پاسخ را می‌فرستد تا کلاینت را به دریافت منبع درخواست‌شده از URI دیگری با درخواست GET هدایت کند.

کاربرد: تغییر مسیر پس از ارسال یک فرم با POST.
304
تغییر نکرده
3xx

برای کش کردن استفاده می‌شود. به کلاینت می‌گوید پاسخ تغییر نکرده است، پس می‌تواند از نسخه کش‌شده خود استفاده کند.

کاربرد: اعتبارسنجی کش مرورگر با هدرهای ETag یا Last-Modified.
307
تغییر مسیر موقت
3xx

سرور این پاسخ را می‌فرستد تا کلاینت را به دریافت منبع درخواست‌شده از URI دیگری با همان متد هدایت کند.

کاربرد: تغییر مسیر موقت با حفظ متد HTTP اصلی.
308
تغییر مسیر دائمی
3xx

تغییر مسیر دائمی که متد HTTP به‌کاررفته در درخواست اصلی را حفظ می‌کند.

کاربرد: جابه‌جایی دائمی نقطه پایانی API با حفظ متد POST.
400
درخواست نامعتبر
4xx

سرور به دلیل نحو نادرست یا ساختار نامعتبر پیام درخواست نمی‌تواند آن را پردازش کند.

کاربرد: بدنه JSON نامعتبر یا نبود پارامترهای الزامی در کوئری.
401
احراز هویت نشده
4xx

احراز هویت لازم است و انجام نشده یا نامعتبر است.

کاربرد: درخواست API بدون توکن یا نشست معتبر.
402
پرداخت لازم است
4xx

برای استفاده در آینده رزرو شده است؛ گاهی برای الزامات پرداخت دیجیتال به کار می‌رود.

کاربرد: دیوار پرداخت یا اشتراک لازم برای دسترسی به محتوا.
403
ممنوع
4xx

کلاینت حق دسترسی به این محتوا را ندارد. برخلاف 401، هویت او مشخص است.

کاربرد: کاربر احراز هویت‌شده‌ای که می‌خواهد به منبع ویژه مدیران دسترسی پیدا کند.
404
پیدا نشد
4xx

سرور نمی‌تواند منبع درخواست‌شده را پیدا کند. آدرس URL شناخته‌شده نیست.

کاربرد: دسترسی به صفحه یا منبعی که وجود ندارد.
405
متد مجاز نیست
4xx

متد درخواست شناخته‌شده است اما برای منبع مقصد پشتیبانی نمی‌شود.

کاربرد: ارسال DELETE به نقطه پایانی که فقط از GET پشتیبانی می‌کند.
406
قابل پذیرش نیست
4xx

سرور نمی‌تواند پاسخی مطابق با فهرست مقادیر قابل قبول تعریف‌شده در هدرهای درخواست تولید کند.

کاربرد: API فقط JSON برمی‌گرداند اما کلاینت XML می‌خواهد.
408
اتمام زمان درخواست
4xx

سرور در بازه زمانی که آماده انتظار بود، پیام کامل درخواست را دریافت نکرد.

کاربرد: کلاینت برای ارسال بدنه درخواست بیش از حد طول می‌دهد.
409
تعارض
4xx

درخواست با وضعیت فعلی سرور در تعارض است.

کاربرد: تلاش برای ساخت نام کاربری‌ای که از قبل وجود دارد.
410
حذف شده
4xx

منبع مقصد دیگر در دسترس نیست و دوباره هم در دسترس نخواهد بود.

کاربرد: محتوای برای همیشه حذف‌شده بدون آدرس جایگزین.
411
طول لازم است
4xx

سرور درخواست را رد کرد زیرا فیلد هدر Content-Length وجود ندارد.

کاربرد: درخواست POST بدون هدر Content-Length.
413
بار درخواست بیش از حد بزرگ
4xx

سرور درخواست را رد می‌کند زیرا حجم بار آن بیش از چیزی است که سرور حاضر به پردازشش باشد.

کاربرد: آپلود فایلی که از حداکثر اندازه مجاز فراتر می‌رود.
414
URI بیش از حد طولانی
4xx

آدرس URI درخواست‌شده از سوی کلاینت طولانی‌تر از چیزی است که سرور حاضر به تفسیرش باشد.

کاربرد: رشته‌های کوئری بسیار طولانی در درخواست‌های GET.
415
نوع رسانه پشتیبانی‌نشده
4xx

سرور از پذیرش درخواست خودداری می‌کند زیرا قالب بار آن پشتیبانی نمی‌شود.

کاربرد: ارسال XML به نقطه پایانی API که فقط JSON می‌پذیرد.
422
موجودیت قابل پردازش نیست
4xx

سرور نوع محتوا را می‌فهمد اما نمی‌تواند دستورهای آن را پردازش کند.

کاربرد: داده فرم با JSON معتبر اما مقادیر نامعتبر در فیلدها.
423
قفل شده
4xx

منبعی که به آن دسترسی خواسته شده قفل است.

کاربرد: منبع WebDAV که کاربر دیگری آن را قفل کرده است.
425
خیلی زود
4xx

نشان می‌دهد سرور حاضر نیست خطر پردازش درخواستی را که ممکن است بازپخش شود بپذیرد.

کاربرد: داده زودهنگام در اتصال‌های TLS 1.3.
429
درخواست‌های بیش از حد
4xx

کاربر در بازه زمانی مشخصی درخواست‌های بیش از حد فرستاده است (محدودیت نرخ).

کاربرد: عبور از محدودیت نرخ API؛ کلاینت باید سرعت را کم کند.
431
فیلدهای هدر درخواست بیش از حد بزرگ
4xx

سرور از پردازش درخواست خودداری می‌کند زیرا فیلدهای هدر بیش از حد بزرگ هستند.

کاربرد: کوکی‌ها یا هدرهای سفارشی که از محدودیت‌های سرور فراتر می‌روند.
451
به دلایل قانونی در دسترس نیست
4xx

سرور به دلیل الزامات قانونی دسترسی به یک منبع را رد می‌کند.

کاربرد: محتوای مسدودشده به دلیل درخواست حذف DMCA یا دستور قانونی.
500
خطای داخلی سرور
5xx

سرور با وضعیتی روبه‌رو شده که نمی‌داند چگونه آن را مدیریت کند.

کاربرد: استثنای مدیریت‌نشده در کد سمت سرور.
501
پیاده‌سازی نشده
5xx

متد درخواست از سوی سرور پشتیبانی نمی‌شود و قابل مدیریت نیست.

کاربرد: سرور از متد PATCH روی یک منبع پشتیبانی نمی‌کند.
502
درگاه نامعتبر
5xx

سرور که نقش دروازه را دارد، پاسخ نامعتبری از سرور بالادست گرفته است.

کاربرد: دریافت پاسخ نادرست از سرور بک‌اند در Nginx.
503
سرویس در دسترس نیست
5xx

سرور آماده رسیدگی به درخواست نیست. دلایل رایج آن توقف برای نگهداری یا بار بیش از حد است.

کاربرد: سرور در حال نگهداری یا با ترافیک بالا.
504
اتمام زمان درگاه
5xx

سرور که نقش دروازه را دارد، پاسخ به‌موقعی از سرور بالادست دریافت نکرد.

کاربرد: API بالادست بیش از حد طول می‌دهد تا پاسخ دهد.
505
نسخه HTTP پشتیبانی نمی‌شود
5xx

نسخه HTTP استفاده‌شده در درخواست از سوی سرور پشتیبانی نمی‌شود.

کاربرد: کلاینتی که از HTTP/3 استفاده می‌کند در برابر سروری که فقط از HTTP/1.1 پشتیبانی می‌کند.
506
گونه نیز مذاکره می‌کند
5xx

سرور در مذاکره شفاف محتوا یک خطای پیکربندی داخلی دارد.

کاربرد: پیکربندی نادرست مذاکره محتوا روی سرور.
507
فضای ذخیره‌سازی ناکافی
5xx

سرور نمی‌تواند بازنمایی لازم برای تکمیل درخواست را ذخیره کند.

کاربرد: تمام‌شدن فضای ذخیره‌سازی در سرور WebDAV.
508
حلقه شناسایی شد
5xx

سرور هنگام پردازش درخواست یک حلقه بی‌پایان شناسایی کرد.

کاربرد: درخواست WebDAV که ارجاع‌های حلقوی می‌سازد.
510
گسترش نیافته
5xx

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

کاربرد: کلاینت باید درخواستی مطابق HTTP Extension Framework بفرستد.
511
احراز هویت شبکه لازم است
5xx

کلاینت برای دسترسی به شبکه باید احراز هویت شود.

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

راهنمای مرجع همه کدهای وضعیت HTTP همراه با توضیحات.

کدهای وضعیت HTTP ابزاری رایگان در دستهٔ «ابزار توسعه‌دهندگان» در BrowseryTools است. بدون نصب، بدون ثبت‌نام و بدون تبلیغات و واترمارک در مرورگر شما اجرا می‌شود. این ابزار هیچ محتوایی از شما نمی‌خواهد، پس اصلاً چیزی برای آپلود یا ذخیره کردن وجود ندارد.