400Bad Request (درخواست نامعتبر)
سرور نمیتواند درخواست را پردازش کند زیرا نحو (syntax)، قاببندی (framing) یا دادههای ارائهشده نامعتبر هستند. تکرار همان درخواست بدون تغییر بعید است کمکی کند.
راهنمایی عملیاتی: Inspect URL encoding, JSON/body syntax, required fields, and request framing.
401Unauthorized (احراز هویتنشده / غیرمجاز)
درخواست فاقد اعتبارنامه احراز هویت معتبر برای مقصد است. برخلاف نامش، این پاسخ به این معناست که احراز هویت الزامی است یا شکست خورده است.
راهنمایی عملیاتی: Send the expected credentials and include a WWW-Authenticate challenge.
402Payment Required (پرداخت الزامی است)
برای استفاده در آینده رزرو شده است، هرچند برخی محصولات از آن برای جریانهای کاری پرداخت یا سهمیه استفاده میکنند. هیچ رفتار پرداخت واحدی که بهطور جهانی قابل تعامل باشد وجود ندارد.
راهنمایی عملیاتی: Treat vendor-specific meanings as such; document the API contract.
403Forbidden (دسترسی ممنوع)
سرور درخواست را متوجه شده اما از برآورده کردن آن خودداری میکند. اعتبارنامههای معتبر لزوماً نتیجه را تغییر نمیدهند زیرا محدودیت ممکن است مبتنی بر سیاست باشد.
راهنمایی عملیاتی: Check permissions, access policy, IP/WAF rules, and resource-level authorization.
سرور نمیتواند بازنمایی فعلی برای URI درخواست شده پیدا کند، یا تمایلی به فاش کردن وجود آن ندارد. پاسخ به تنهایی نمیگوید که آیا غیبت موقت است یا دائم.
راهنمایی عملیاتی: Repair the URL, restore the resource, or use 410 when removal is known to be permanent.
405Method Not Allowed (روش مجاز نیست)
منبع وجود دارد، اما از روش استفاده شده در این درخواست پشتیبانی نمیکند.
راهنمایی عملیاتی: Return an Allow header listing methods the resource accepts.
406Not Acceptable (غیرقابل قبول)
سرور نمیتواند بازنمایی مطابق با ترجیحات پذیرش فعال کلاینت تولید کند.
راهنمایی عملیاتی: Relax Accept constraints or configure a suitable representation/negotiation policy.
407Proxy Authentication Required (احراز هویت پروکسی الزامی است)
یک پروکسی واسطه قبل از اینکه درخواست را جلو ببرد به اعتبارنامه نیاز دارد.
راهنمایی عملیاتی: Authenticate to the proxy using Proxy-Authenticate / Proxy-Authorization; this is distinct from origin authentication.
408Request Timeout (پایان مهلت درخواست)
سرور درخواست کامل را در زمانی که برای انتظار آماده بود دریافت نکرد. کلاینت ممکن است در یک اتصال جدید دوباره تلاش کند.
راهنمایی عملیاتی: Check network stalls, upload size, and server/proxy timeout settings.
409Conflict (تضاد / تعارض)
درخواست با وضعیت فعلی منبع تضاد دارد، مانند برخورد نسخه یا تلاشی برای ایجاد یک مورد تکراری.
راهنمایی عملیاتی: Explain the conflict and provide enough current state for the client to resolve it.
410Gone (از دست رفته / حذف شده)
منبع بهطور عمدی و احتمالاً برای همیشه در دسترس نیست و جایگزین شناختهشدهای ندارد. این قویتر از یک پاسخ عمومی یافتنشده است.
راهنمایی عملیاتی: Use when removal is deliberate; remove obsolete internal links and references.
411Length Required (طول الزامی است)
سرور به یک هدر Content-Length نیاز دارد اما درخواست یکی را فراهم نکرده است.
راهنمایی عملیاتی: Send an accurate Content-Length or use a supported transfer framing.
412Precondition Failed (پیششرط شکست خورد)
یک شرط درخواست مانند If-Match نادرست ارزیابی شد، بنابراین سرور عمل درخواست شده را انجام نداد.
راهنمایی عملیاتی: Refresh the representation and retry with current validators/state.
413Content Too Large (محتوا بیش از حد بزرگ است)
بدنه درخواست از حد مجازی که سرور مایل یا قادر به پردازش آن است فراتر میرود. سرور ممکن است اتصال را ببندد یا پس از کاهش بدنه اجازه تلاش مجدد دهد.
راهنمایی عملیاتی: Reduce payload size or adjust documented upload limits.
414URI Too Long (شناسه URI بیش از حد طولانی است)
هدف درخواست طولانیتر از آن چیزی است که سرور مایل به تفسیر آن باشد، که اغلب به دلیل یک رشته پرسوجو (query string) بیش از حد بزرگ است.
راهنمایی عملیاتی: Use a shorter URI or move suitable data into a request body.
415Unsupported Media Type (نوع رسانه پشتیبانی نمیشود)
سرور بدنه درخواست را رد میکند زیرا نوع رسانه، کدگذاری محتوا یا فرمت بازرسی شده آن پشتیبانی نمیشود.
راهنمایی عملیاتی: Send a supported Content-Type/encoding and a body matching it.
416Range Not Satisfiable (محدوده قابل برآورده شدن نیست)
محدوده بایت درخواست شده قابل سرویسدهی نیست، به عنوان مثال زیرا از طول بازنمایی فراتر شروع میشود.
راهنمایی عملیاتی: Re-check resource length and range units; servers may return Content-Range: bytes */length.
417Expectation Failed (انتظار برآورده نشد)
سرور یا واسطه نمیتواند انتظاری را که در هدر expect اعلام شده برآورده کند.
راهنمایی عملیاتی: Retry without the unsupported expectation when safe and appropriate.
418I'm a teapot (من یک قوری چای هستم)
یک وضعیت طنزآمیز که از یک مشخصات روز اول آوریل سرچشمه گرفته است. این یک قرارداد خطای برنامهنویسی عادی نیست، هرچند برخی سرویسها به شوخی از آن استفاده میکنند.
راهنمایی عملیاتی: Do not depend on it for interoperable production behavior.
421Misdirected Request (درخواست اشتباه هدایتشده)
درخواست به سروری رسیده است که نمیتواند پاسخ معتبری برای URI هدف تولید کند، اغلب به این دلیل که مسیریابی اتصال یا مرجع HTTP مطابقت ندارد.
راهنمایی عملیاتی: Retry over a suitable connection and inspect Host/:authority, SNI, and proxy routing.
422Unprocessable Content (محتوای غیرقابل پردازش)
نوع محتوا و نحو درک شدهاند، اما سرور نمیتواند دستورالعملها را اعمال کند یا محتوای ارسال شده را اعتبارسنچی کند.
راهنمایی عملیاتی: Return actionable field-level validation details; correcting the payload may allow success.
یک منبع WebDAV قفل شده است، بنابراین روش درخواست شده تا زمانی که شرط قفل حل شود قابل اجرا نیست.
راهنمایی عملیاتی: Check lock ownership, timeout, and WebDAV lock-token handling.
424Failed Dependency (وابستگی ناموفق)
یک عملیات WebDAV شکست خورد زیرا یک عملیات قبلی مورد نیاز در همان دنباله درخواست شکست خورده بود.
راهنمایی عملیاتی: Resolve the earlier failed action before retrying dependent operations.
سرور از پردازش درخواستی که ممکن است در طول دادههای اولیه (early data) تکرار شده باشد، برای کاهش خطر پخش مجدد خودداری میکند.
راهنمایی عملیاتی: Retry after the connection is established without early data.
426Upgrade Required (ارتقا الزامی است)
سرور از پروتکل فعلی امتناع میورزد و نشان میدهد که کلاینت باید به پروتکل دیگری تغییر وضعیت دهد.
راهنمایی عملیاتی: Include an Upgrade header that describes supported protocol choices.
428Precondition Required (پیششرط الزامی است)
سرور برای جلوگیری از بهروزرسانیهای از دست رفته به یک درخواست مشروط نیاز دارد، اما کلاینت یک درخواست غیرمشروط ارسال کرده است.
راهنمایی عملیاتی: Fetch current state and submit an appropriate condition such as If-Match.
429Too Many Requests (درخواستهای بیش از حد)
کلاینت درخواستهای زیادی را در یک دوره مشخص، بر اساس محدودیت نرخ تعریفشده توسط سرور ارسال کرده است.
راهنمایی عملیاتی: Back off, honor Retry-After when present, and avoid synchronized retry bursts.
431Request Header Fields Too Large (فیلدهای هدر درخواست بیش از حد بزرگ هستند)
سرور درخواست را پردازش نخواهد کرد زیرا یک یا چند فیلد هدر، یا مجموعه هدر ترکیبی، بسیار بزرگ است.
راهنمایی عملیاتی: Reduce cookies/custom headers or adjust an intentional server limit.
451Unavailable For Legal Reasons (به دلایل قانونی در دسترس نیست)
سرور نمیتواند منبع درخواست شده را به دلیل محدودیت قانونی فراهم کند.
راهنمایی عملیاتی: Where appropriate, explain the restriction and its scope without exposing protected information.