100
Continue
ادامه بده
بخش ابتدایی درخواست پذیرفته شده و کاربر می‌تواند بدنه درخواست را ارسال کند.
کاربرد و اقدام مناسب
پس از دریافت 100، ارسال بدنه درخواست را ادامه دهید.
مشاهده مرجع رسمیمرجع کدهای وضعیت HTTP
کد، معنی فارسی، کاربرد و اقدام مناسب را بر پایه رجیستری رسمی پیدا کنید.
1xx
5 کداطلاعرسانی
درخواست دریافت شده و پردازش ادامه دارد.
101
Switching Protocols
تغییر پروتکل
سرور با تغییر پروتکل پیشنهادی در هدر Upgrade موافقت کرده است.
کاربرد و اقدام مناسب
اتصال را طبق پروتکل توافق‌شده ادامه دهید.
مشاهده مرجع رسمی102
Processing
در حال پردازش
در WebDAV یعنی درخواست پذیرفته شده اما پردازش آن هنوز کامل نشده است.
کاربرد و اقدام مناسب
منتظر پاسخ نهایی بمانید و بی‌دلیل درخواست را تکرار نکنید.
مشاهده مرجع رسمی103
Early Hints
راهنمایی زودهنگام
هدرهای اولیه، معمولاً برای preload، پیش از پاسخ نهایی فرستاده می‌شوند.
کاربرد و اقدام مناسب
کلاینت می‌تواند منابع اعلام‌شده را زودتر بارگیری کند؛ پاسخ نهایی هنوز در راه است.
مشاهده مرجع رسمی104موقت
Upload Resumption Supported
پشتیبانی از ادامه آپلود
ثبت موقت برای اعلام پشتیبانی از ادامه‌دادن آپلود ناتمام است.
کاربرد و اقدام مناسب
این کد موقت است و ثبت فعلی آن در ۲۲ آبان ۱۴۰۵ منقضی می‌شود؛ برای پیاده‌سازی، رجیستری IANA را دوباره بررسی کنید.
مشاهده مرجع رسمی2xx
10 کدموفق
درخواست دریافت، فهم و با موفقیت پردازش شده است.
200
OK
موفق
درخواست با موفقیت انجام شده و معنای بدنه به متد درخواست وابسته است.
کاربرد و اقدام مناسب
پاسخ عادی موفق؛ بدنه و هدرها را طبق قرارداد API پردازش کنید.
مشاهده مرجع رسمی201
Created
ایجاد شد
درخواست موفق بوده و یک یا چند منبع جدید ایجاد شده‌اند.
کاربرد و اقدام مناسب
نشانی منبع ساخته‌شده را ترجیحاً در هدر Location برگردانید.
مشاهده مرجع رسمی202
Accepted
پذیرفته شد
درخواست برای پردازش پذیرفته شده اما پردازش هنوز کامل نیست.
کاربرد و اقدام مناسب
برای کار غیرهم‌زمان، وضعیت یا نشانی پیگیری را در پاسخ قرار دهید.
مشاهده مرجع رسمی203
Non-Authoritative Information
اطلاعات غیرمعتبر از مبدأ
درخواست موفق است اما فراداده پاسخ توسط واسطی نسبت به مبدأ تغییر کرده است.
کاربرد و اقدام مناسب
برای اعتبارسنجی یا کش، تفاوت پاسخ واسط با سرور مبدأ را در نظر بگیرید.
مشاهده مرجع رسمی204
No Content
بدون محتوا
درخواست موفق است و بدنه‌ای برای ارسال وجود ندارد.
کاربرد و اقدام مناسب
برای عملیات موفقی که خروجی نمایشی ندارد مناسب است.
مشاهده مرجع رسمی205
Reset Content
بازنشانی محتوا
درخواست موفق است و کاربر باید نمای ورودی را به حالت اولیه برگرداند.
کاربرد و اقدام مناسب
رابط کاربری، مثلاً فرم ثبت‌شده، را پاک یا بازنشانی کنید.
مشاهده مرجع رسمی206
Partial Content
محتوای جزئی
سرور بخشی از منبع را در پاسخ به یک درخواست Range ارسال کرده است.
کاربرد و اقدام مناسب
هدر Content-Range را بررسی و قطعه را در جای درست بازسازی کنید.
مشاهده مرجع رسمی207
Multi-Status
چندوضعیتی
در WebDAV وضعیت چند عملیات یا منبع در یک پاسخ گزارش می‌شود.
کاربرد و اقدام مناسب
بدنه XML را برای وضعیت مستقل هر منبع پردازش کنید.
مشاهده مرجع رسمی208
Already Reported
قبلاً گزارش شده
در WebDAV عضو یک اتصال قبلاً در همان پاسخ چندوضعیتی گزارش شده است.
کاربرد و اقدام مناسب
از پردازش یا نمایش دوباره همان عضو جلوگیری کنید.
مشاهده مرجع رسمی226
IM Used
استفاده از دستکاری نمونه
سرور درخواست GET را با یک یا چند instance-manipulation روی منبع انجام داده است.
کاربرد و اقدام مناسب
هدر IM و سازگاری کلاینت با تبدیل اعمال‌شده را بررسی کنید.
مشاهده مرجع رسمی3xx
9 کدتغییر مسیر
برای تکمیل درخواست اقدام یا مقصد دیگری لازم است.
300
Multiple Choices
انتخاب‌های متعدد
منبع بیش از یک نمایش یا مقصد ممکن دارد و کاربر باید انتخاب کند.
کاربرد و اقدام مناسب
فهرست گزینه‌ها و در صورت امکان مقصد ترجیحی را ارائه دهید.
مشاهده مرجع رسمی301
Moved Permanently
انتقال دائمی
منبع به‌صورت دائمی به URI جدید منتقل شده است.
کاربرد و اقدام مناسب
برای مهاجرت دائمی URL استفاده و Location معتبر ارسال کنید.
مشاهده مرجع رسمی302
Found
یافت شد؛ انتقال موقت
منبع موقتاً در URI دیگری قرار دارد.
کاربرد و اقدام مناسب
کلاینت معمولاً Location را دنبال میکند؛ برای حفظ متد، 307 روشنتر است.
مشاهده مرجع رسمی303
See Other
مقصد دیگر را ببین
نتیجه عملیات باید با یک درخواست GET به URI دیگری دریافت شود.
کاربرد و اقدام مناسب
پس از POST برای هدایت کاربر به صفحه نتیجه یا رسید مناسب است.
مشاهده مرجع رسمی304
Not Modified
تغییر نکرده
شرط کش برقرار است و نسخه ذخیره‌شده هنوز معتبر است؛ بدنه‌ای ارسال نمی‌شود.
کاربرد و اقدام مناسب
نسخه کش‌شده را استفاده و هدرهای اعتبارسنجی را به‌روزرسانی کنید.
مشاهده مرجع رسمی305منسوخ
Use Proxy
استفاده از پراکسی
کد قدیمی برای دسترسی از طریق پراکسی بود و به‌دلیل ملاحظات امنیتی منسوخ شده است.
کاربرد و اقدام مناسب
در پیاده‌سازی جدید استفاده نکنید.
مشاهده مرجع رسمی306منسوخ
(Unused)
استفاده‌نشده
این شماره رزرو است و معنای عملی فعالی ندارد.
کاربرد و اقدام مناسب
در پاسخ برنامه از آن استفاده نکنید.
مشاهده مرجع رسمی307
Temporary Redirect
انتقال موقت با حفظ متد
مقصد موقت عوض شده و کلاینت باید متد و بدنه درخواست را حفظ کند.
کاربرد و اقدام مناسب
برای انتقال موقت POST یا سایر متدها بدون تبدیل به GET مناسب است.
مشاهده مرجع رسمی308
Permanent Redirect
انتقال دائمی با حفظ متد
مقصد دائماً عوض شده و متد و بدنه درخواست باید حفظ شوند.
کاربرد و اقدام مناسب
برای مهاجرت دائمی endpoint با حفظ رفتار درخواست مناسب است.
مشاهده مرجع رسمی4xx
29 کدخطای سمت کاربر
درخواست، مجوز یا منبع درخواستی مشکل دارد.
400
Bad Request
درخواست نامعتبر
سرور به‌دلیل نحو یا چارچوب نامعتبر نمی‌تواند درخواست را پردازش کند.
کاربرد و اقدام مناسب
قالب JSON، پارامترها، encoding و هدرهای درخواست را اصلاح کنید.
مشاهده مرجع رسمی401
Unauthorized
نیازمند احراز هویت
درخواست فاقد اطلاعات احراز هویت معتبر برای منبع محافظت‌شده است.
کاربرد و اقدام مناسب
اعتبارنامه معتبر ارسال کنید؛ پاسخ باید WWW-Authenticate داشته باشد.
مشاهده مرجع رسمی402
Payment Required
نیازمند پرداخت
برای استفاده آینده رزرو شده و معنای استاندارد عملی تثبیت‌شده‌ای ندارد.
کاربرد و اقدام مناسب
اگر در API خصوصی استفاده می‌شود، قرارداد دقیق آن را مستند کنید.
مشاهده مرجع رسمی403
Forbidden
دسترسی ممنوع
سرور درخواست را فهمیده اما اجازه انجام آن را نمی‌دهد.
کاربرد و اقدام مناسب
سطح دسترسی را بررسی کنید؛ تکرار همان درخواست بدون تغییر فایده ندارد.
مشاهده مرجع رسمی404
Not Found
پیدا نشد
سرور منبع متناظر را پیدا نکرده یا نمی‌خواهد وجود آن را افشا کند.
کاربرد و اقدام مناسب
URL، روت، شناسه منبع و وضعیت انتشار را بررسی کنید.
مشاهده مرجع رسمی405
Method Not Allowed
متد مجاز نیست
منبع وجود دارد اما متد HTTP استفاده‌شده برای آن مجاز نیست.
کاربرد و اقدام مناسب
هدر Allow را بخوانید و GET، POST، PUT یا متد صحیح را بفرستید.
مشاهده مرجع رسمی406
Not Acceptable
خروجی قابل قبول نیست
هیچ نمایش موجودی با شروط Accept درخواست سازگار نیست.
کاربرد و اقدام مناسب
هدرهای Accept، زبان یا نوع رسانه درخواستی را تغییر دهید.
مشاهده مرجع رسمی407
Proxy Authentication Required
احراز هویت پراکسی لازم است
برای استفاده از پراکسی باید اعتبارنامه معتبر ارائه شود.
کاربرد و اقدام مناسب
چالش Proxy-Authenticate را پردازش و اعتبارنامه پراکسی را ارسال کنید.
مشاهده مرجع رسمی408
Request Timeout
مهلت درخواست تمام شد
سرور در زمان مقرر درخواست کامل را دریافت نکرده است.
کاربرد و اقدام مناسب
اتصال و اندازه درخواست را بررسی و فقط در صورت امن‌بودن عملیات دوباره تلاش کنید.
مشاهده مرجع رسمی409
Conflict
تعارض
درخواست با وضعیت فعلی منبع تعارض دارد.
کاربرد و اقدام مناسب
نسخه یا وضعیت فعلی را دریافت، تعارض را حل و سپس درخواست را تکرار کنید.
مشاهده مرجع رسمی410
Gone
برای همیشه حذف شده
منبع عمداً حذف شده و انتظار نمی‌رود دوباره در دسترس قرار گیرد.
کاربرد و اقدام مناسب
لینک را حذف یا به جایگزین دائمی هدایت کنید؛ برای حذف از ایندکس روشنتر از 404 است.
مشاهده مرجع رسمی411
Length Required
طول محتوا لازم است
سرور بدون Content-Length تعریف‌شده درخواست را نمی‌پذیرد.
کاربرد و اقدام مناسب
طول صحیح بدنه را ارسال کنید.
مشاهده مرجع رسمی412
Precondition Failed
پیش‌شرط برقرار نیست
یک یا چند شرط درخواست مانند If-Match برقرار نشده است.
کاربرد و اقدام مناسب
ETag یا زمان آخرین تغییر را تازه کنید و تعارض هم‌زمانی را حل کنید.
مشاهده مرجع رسمی413
Content Too Large
محتوا بیش از حد بزرگ است
بدنه درخواست از حدی که سرور می‌پذیرد بزرگ‌تر است.
کاربرد و اقدام مناسب
فایل یا payload را کوچک، قطعه‌بندی یا محدودیت سرور را آگاهانه تنظیم کنید.
مشاهده مرجع رسمی414
URI Too Long
نشانی بیش از حد طولانی است
URI درخواست طولانی‌تر از حد قابل پردازش سرور است.
کاربرد و اقدام مناسب
داده بزرگ را از query string به بدنه درخواست منتقل کنید.
مشاهده مرجع رسمی415
Unsupported Media Type
نوع رسانه پشتیبانی نمی‌شود
قالب بدنه یا Content-Type برای این منبع پشتیبانی نمی‌شود.
کاربرد و اقدام مناسب
Content-Type و encoding را با قرارداد endpoint هماهنگ کنید.
مشاهده مرجع رسمی416
Range Not Satisfiable
بازه قابل ارائه نیست
بازه درخواستی خارج از محدوده منبع یا نامعتبر است.
کاربرد و اقدام مناسب
اندازه منبع و هدر Content-Range را بررسی و Range را اصلاح کنید.
مشاهده مرجع رسمی417
Expectation Failed
انتظار برآورده نشد
سرور نمی‌تواند انتظار درج‌شده در هدر Expect را برآورده کند.
کاربرد و اقدام مناسب
هدر Expect را حذف یا با قابلیت سرور هماهنگ کنید.
مشاهده مرجع رسمی418
(Unused)
استفاده‌نشده
در استاندارد اصلی HTTP این کد استفاده‌نشده است؛ نام مشهور «قوری هستم» از RFC طنزآمیز 2324 می‌آید.
کاربرد و اقدام مناسب
برای خطای واقعی API استفاده نکنید، مگر در یک قرارداد غیررسمی و کاملاً مستند.
مشاهده مرجع رسمی421
Misdirected Request
درخواست به سرور نادرست رسیده
درخواست به سروری رسیده که قادر به تولید پاسخ معتبر برای مقصد نیست.
کاربرد و اقدام مناسب
اتصال بازاستفاده‌شده، SNI، Host و پیکربندی HTTP/2 را بررسی کنید.
مشاهده مرجع رسمی422
Unprocessable Content
محتوای پردازش‌ناپذیر
نوع و نحو محتوا درست است، اما دستورهای درون آن از نظر معنایی قابل انجام نیستند.
کاربرد و اقدام مناسب
خطاهای اعتبارسنجی فیلدها را برگردانید و ورودی را اصلاح کنید.
مشاهده مرجع رسمی423
Locked
قفل شده
منبع WebDAV قفل است و عملیات روی آن انجام نمی‌شود.
کاربرد و اقدام مناسب
قفل معتبر را ارائه دهید یا تا آزادشدن منبع صبر کنید.
مشاهده مرجع رسمی424
Failed Dependency
وابستگی ناموفق
عملیات به عملیات دیگری وابسته بود که شکست خورده است.
کاربرد و اقدام مناسب
نخست خطای عملیات وابسته را پیدا و برطرف کنید.
مشاهده مرجع رسمی425
Too Early
درخواست خیلی زود ارسال شده
سرور حاضر نیست ریسک پردازش درخواست قابل replay را بپذیرد.
کاربرد و اقدام مناسب
درخواست را بدون early data و با اتصال کامل دوباره ارسال کنید.
مشاهده مرجع رسمی426
Upgrade Required
ارتقای پروتکل لازم است
سرور انجام درخواست را تا تغییر به پروتکل دیگری رد میکند.
کاربرد و اقدام مناسب
هدر Upgrade را بخوانید و در صورت پشتیبانی، پروتکل را ارتقا دهید.
مشاهده مرجع رسمی428
Precondition Required
پیش‌شرط لازم است
سرور می‌خواهد درخواست شرطی باشد تا از بازنویسی ناخواسته جلوگیری شود.
کاربرد و اقدام مناسب
If-Match یا پیش‌شرط مناسب را با ETag تازه ارسال کنید.
مشاهده مرجع رسمی429
Too Many Requests
درخواست بیش از حد
کاربر یا کلاینت در بازه زمانی مشخص درخواست‌های زیادی فرستاده است.
کاربرد و اقدام مناسب
Retry-After را رعایت کنید و backoff نمایی و محدودسازی درخواست به‌کار ببرید.
مشاهده مرجع رسمی431
Request Header Fields Too Large
هدرهای درخواست بیش از حد بزرگ‌اند
یک هدر یا مجموع هدرهای درخواست از حد مجاز سرور بیشتر است.
کاربرد و اقدام مناسب
کوکی‌ها و هدرهای غیرضروری را کم کنید و محدودیت را بی‌دلیل بالا نبرید.
مشاهده مرجع رسمی451
Unavailable For Legal Reasons
به دلایل قانونی در دسترس نیست
دسترسی به منبع در نتیجه یک مطالبه یا محدودیت قانونی ممکن نیست.
کاربرد و اقدام مناسب
در صورت امکان، مرجع محدودیت را در هدر Link با rel=blocked-by اعلام کنید.
مشاهده مرجع رسمی5xx
11 کدخطای سمت سرور
سرور نتوانسته یک درخواست ظاهراً معتبر را انجام دهد.
500
Internal Server Error
خطای داخلی سرور
سرور با وضعیت پیش‌بینی‌نشده‌ای روبه‌رو شده و درخواست را کامل نکرده است.
کاربرد و اقدام مناسب
شناسه رخداد را ثبت کنید؛ جزئیات stack trace را به کاربر ندهید و لاگ سرور را بررسی کنید.
مشاهده مرجع رسمی501
Not Implemented
پیاده‌سازی نشده
سرور قابلیت لازم برای انجام متد یا عملکرد درخواست را ندارد.
کاربرد و اقدام مناسب
پشتیبانی endpoint یا متد را پیاده‌سازی کنید؛ با 405 اشتباه نگیرید.
مشاهده مرجع رسمی502
Bad Gateway
پاسخ نامعتبر از سرور بالادست
گیت‌وی یا پراکسی از سرور بالادست پاسخ نامعتبر دریافت کرده است.
کاربرد و اقدام مناسب
سلامت upstream، DNS، TLS، timeout و قالب پاسخ را بررسی کنید.
مشاهده مرجع رسمی503
Service Unavailable
سرویس موقتاً در دسترس نیست
سرور به‌دلیل بار زیاد یا نگهداری موقتاً قادر به پاسخ‌گویی نیست.
کاربرد و اقدام مناسب
Retry-After ارسال کنید؛ کلاینت با فاصله و backoff دوباره تلاش کند.
مشاهده مرجع رسمی504
Gateway Timeout
پایان مهلت سرور بالادست
گیت‌وی یا پراکسی در زمان مقرر از upstream پاسخ نگرفته است.
کاربرد و اقدام مناسب
timeout و کارایی سرویس بالادست و اتصال بین سرویس‌ها را بررسی کنید.
مشاهده مرجع رسمی505
HTTP Version Not Supported
نسخه HTTP پشتیبانی نمی‌شود
سرور نسخه اصلی HTTP استفاده‌شده در درخواست را پشتیبانی نمی‌کند.
کاربرد و اقدام مناسب
با نسخه پشتیبانی‌شده درخواست بفرستید یا پیکربندی واسط را اصلاح کنید.
مشاهده مرجع رسمی506
Variant Also Negotiates
گونه نیز مذاکره محتوا انجام میدهد
پیکربندی Transparent Content Negotiation یک حلقه یا مرجع نادرست ساخته است.
کاربرد و اقدام مناسب
پیکربندی variant و مذاکره محتوا در سرور را اصلاح کنید.
مشاهده مرجع رسمی507
Insufficient Storage
فضای ذخیره‌سازی ناکافی
سرور فضای لازم برای تکمیل عملیات WebDAV را ندارد.
کاربرد و اقدام مناسب
فضا یا سهمیه را آزاد کنید و سپس عملیات را تکرار کنید.
مشاهده مرجع رسمی508
Loop Detected
حلقه شناسایی شد
سرور هنگام پردازش WebDAV یک حلقه بی‌پایان را تشخیص داده است.
کاربرد و اقدام مناسب
منابع متصل، bindingها یا منطق پیمایش را برای چرخه بررسی کنید.
مشاهده مرجع رسمی510منسوخ
Not Extended
گسترش لازم انجام نشده
این کد منسوخ شده و درخواست سیاست گسترش لازم را برآورده نکرده بود.
کاربرد و اقدام مناسب
در پیاده‌سازی جدید استفاده نکنید.
مشاهده مرجع رسمی511
Network Authentication Required
احراز هویت شبکه لازم است
برای دسترسی به شبکه، معمولاً از طریق captive portal، احراز هویت لازم است.
کاربرد و اقدام مناسب
کاربر را به ورود شبکه هدایت کنید؛ این کد برای سرور مبدأ نیست.
مشاهده مرجع رسمی⌕کدی با این جستوجو پیدا نشد
عبارت کوتاهتر یا خانواده دیگری را امتحان کنید.
راهنمای انتخاب
کد دقیق‌تر، قرارداد روشنتر
کد وضعیت فقط خلاصه نتیجه درخواست است. بدنه خطا باید پیام قابل فهم و شناسه پیگیری داشته باشد، اما اطلاعات حساس یا stack trace نباید برای کاربر عمومی نمایش داده شود. بین کدهای نزدیک، معنای استاندارد و رفتار واقعی کلاینت را ملاک قرار دهید.
پرسش‌های متداول
سؤال‌های رایج کدهای HTTP
تفاوت خطای 401 و 403 چیست؟
401 یعنی اعتبارنامه معتبر ارائه نشده و پاسخ باید روش احراز هویت را اعلام کند. 403 یعنی سرور درخواست را فهمیده اما اجازه انجام آن را نمی‌دهد؛ حتی ممکن است کاربر احراز هویت شده باشد.
برای صفحه حذفشده 404 بهتر است یا 410؟
اگر نمیدانید منبع برمیگردد یا نه، 404 عمومیتر است. وقتی حذف دائمی و عمدی منبع قطعی است، 410 این وضعیت را روشنتر اعلام میکند.
فرق 301 و 308 چیست؟
هر دو انتقال دائمیاند. 308 صریحاً میگوید متد و بدنه درخواست حفظ شوند؛ 301 در عمل ممکن است توسط بعضی کلاینتها برای درخواست POST به GET تبدیل شود.
فرق 500، 502، 503 و 504 چیست؟
500 خطای پیشبینینشده داخل همان سرور است؛ 502 پاسخ نامعتبر upstream، 503 عدم دسترسی موقت سرویس و 504 پایان مهلت پاسخ سرور بالادست را نشان میدهد.
آیا کد 418 واقعاً به معنی قوری است؟
این نام از RFC طنزآمیز 2324 مشهور شده است، اما در رجیستری اصلی HTTP، 418 به‌عنوان استفاده‌نشده ثبت شده و برای قراردادهای واقعی توصیه نمی‌شود.
روش و منابع معتبر
رجیستری رسمی کدهای وضعیت HTTP
فهرست کدها از رجیستری IANA و معنای اصلی خانواده‌ها و کدهای عمومی از استاندارد HTTP Semantics استخراج شده است. کدهای توسعه‌ای به RFC ثبت‌کننده خود پیوند دارند.
مهم: کد ۱۰۴ ثبت موقت دارد و وضعیت آن باید پس از ۲۲ آبان ۱۴۰۵ دوباره با IANA تطبیق داده شود. کدهای اختصاصی بعضی سرویس‌ها جزو رجیستری استاندارد نیستند.
