مرجع کدهای وضعیت HTTP

این ابزار چه کاری انجام می‌دهد

هر بار که یک مرورگر، برنامه یا اسکریپت با سرور ارتباط برقرار می‌کند، پاسخ با یک کد وضعیت سه‌رقمی برمی‌گردد — مانند 200، 404، 500 و موارد دیگر. این ابزار راهی سریع برای پیدا کردن هر کد است؛ بدون اینکه لازم باشد در یک RFC جست‌وجو کنید یا جدول ثابت ویکی‌پدیا را بالا و پایین ببرید. یک کد یا کلمه کلیدی وارد کنید تا نام رسمی، معنای واقعی آن در عمل و دسته‌بندی‌اش را ببینید (اطلاع‌رسانی، موفقیت، تغییر مسیر، خطای سمت کاربر یا خطای سمت سرور).

نحوه استفاده از آن

در کادر جست‌وجو شروع به تایپ کنید — یک شماره کد مانند "429"، نامی مانند "not found" یا مفهومی مانند "rate limit" همگی قابل استفاده هستند. هنگام بررسی گزارش‌ها، از دکمه‌های دسته‌بندی بالای جست‌وجو استفاده کنید تا نتایج را فقط به تغییر مسیرها یا فقط به خطاهای سمت سرور محدود کنید. برای کپی کردن "404 Not Found" در کلیپ‌بورد، روی نماد کلیپ‌بورد هر کارت کلیک کنید تا بتوانید آن را مستقیماً در گزارش باگ، پیام کامیت یا مستندات API قرار دهید.

موارد استفاده رایج

• اشکال‌زدایی یک فراخوانی ناموفق API و مشخص کردن اینکه مشکل از سمت شما (4xx) است یا از سمت سرور (5xx)
• نوشتن مستندات API و نیاز داشتن به نام دقیق و درستِ وضعیت
• پیکربندی پروکسی معکوس یا CDN و تعیین اینکه کدام کد تغییرمسیر (301 در برابر 302 در برابر 307) واقعاً با شرایط مطابقت دارد
• مطالعه برای مصاحبه یا دورهٔ توسعهٔ وب که مبانی HTTP را پوشش می‌دهد

سؤالات متداول

تفاوت کدهای 401 و 403 چیست؟

کد 401 Unauthorized یعنی هنوز هویت خود را ثابت نکرده‌اید؛ اطلاعات احراز هویت شما وجود ندارد یا نامعتبر است. کد 403 Forbidden یعنی سرور دقیقاً می‌داند شما چه کسی هستید، اما همچنان اجازه ورود نمی‌دهد، چون مجوز لازم را ندارید.

برای تغییر مسیر باید از 301 استفاده کنم یا 302؟

301 به موتورهای جست‌وجو و مرورگرها می‌گوید انتقال دائمی است — آن‌ها نشانک‌ها را به‌روزرسانی می‌کنند و رتبه سئو را به URL جدید منتقل می‌کنند. 302 (یا 307) نشان می‌دهد انتقال موقتی است؛ بنابراین URL اصلی باید همان نشانی‌ای باقی بماند که ذخیره و ایندکس می‌شود.

کد 429 Too Many Requests برای چه کاری استفاده می‌شود؟

این روش استانداردی است که API به کلاینت می‌گوید: «محدودیت نرخ درخواست برایتان اعمال شده است؛ سرعت را کم کنید.» کلاینت‌های درست‌رفتار پس از مدتی مکث، معمولاً با استفاده از هدر Retry-After که سرور همراه پاسخ ارسال می‌کند، دوباره تلاش می‌کنند.

آیا 418 I'm a Teapot یک کد وضعیت واقعی است؟

این کد در ابتدا به‌عنوان شوخی اول آوریل در RFC 2324 در سال 1998 مطرح شد، اما از نظر فنی ثبت شده است و برخی APIها و ابزارهای آزمایش هنوز هم آن را به‌صورت شوخی‌آمیز برمی‌گردانند؛ چیزی نیست که در یک سامانهٔ عملیاتی از آن استفاده کنید.

چرا حتی برای صفحات واقعی، خطای 404 این‌قدر زیاد نمایش داده می‌شود؟

معمولاً به‌دلیل خراب بودن لینک، اشتباه تایپی در URL، حذف یا جابه‌جایی صفحه بدون تغییرمسیر، یا درخواست کلاینت برای منبعی رخ می‌دهد که هنوز در سمت سرور ایجاد نشده است.