HTTP 429 — درخواستهای بیش از حد
یک خطای کلاینت 4xx: درخواست نحو نادرستی دارد یا قابل اجرا نیست.
درخواستهای بیش از حد
کلاینت در یک بازهٔ زمانی مشخص درخواستهای بیش از حد فرستاده است.
معنای آن
کاربر در یک بازهٔ زمانی مشخص درخواستهای بیش از حد فرستاده است («محدودسازی نرخ»). یک سرآیند Retry-After ممکن است مدت انتظار را نشان دهد.
چه زمانی استفاده شود
پاسخ استاندارد برای APIهای محدودشده به نرخ؛ یک سرآیند Retry-After بگنجانید.
سایر کدهای 4xx
درباره کدهای وضعیت HTTP
این راهنمای کدهای وضعیت HTTP تمام کدهای پاسخ استاندارد از محدوده اطلاعاتی 1xx تا خطاهای سرور 5xx را پوشش میدهد. هر مدخل کد عددی، عبارت دلیل معیار آن و یک خلاصه یکخطی را نشان میدهد، و کل فهرست را میتوان بر اساس شماره، نام یا معنا جستجو کرد؛ 301، Unauthorized و timeout همگی نتیجه مطلوب را مییابند؛ یا بر اساس کلاس پاسخ فیلتر کرد.
هر کد به صفحه اختصاصی خودش باز میشود با توضیحی کامل: اینکه وضعیت واقعاً چه معنایی دارد، چه زمانی باید در APIها و برنامههای خودتان از آن استفاده کنید، آیا پاسخهای آن کد بهطور پیشفرض قابل کش هستند یا نه، و RFCای که آن را تعریف میکند. کدهای مرتبط از همان کلاس در پایین صفحه پیوند داده شدهاند، بنابراین مقایسه 401 با 403 یا 301 با 308 تنها یک کلیک زمان میبرد.
پنج کلاس، سریعترین مدل ذهنی برای خواندن هر پاسخی هستند: 1xx یعنی درخواست در حال ادامه است، 2xx یعنی موفقیت، 3xx یعنی هدایت مجدد، 4xx یعنی خطا از سمت کلاینت بوده و 5xx یعنی سرور شکست خورده است. این راهنما دقیقاً حول همین ساختار سازماندهی شده است.
نحوه استفاده از کدهای وضعیت HTTP
- یک کد، عبارت دلیل یا کلیدواژه در کادر جستجو تایپ کنید؛ برای مثال 404، Not Found یا redirect.
- از فیلتر کلاس برای محدودکردن فهرست به کدهای اطلاعاتی، موفقیت، هدایت مجدد، خطای کلاینت یا خطای سرور استفاده کنید.
- صفحه هر کد را باز کنید تا معنای آن، زمان استفاده، قابلیت کش پیشفرض و RFC تعریفکننده آن را بخوانید.
- بخش کدهای مرتبط را برای مقایسه همسایهها از همان کلاس بررسی کنید.
- از دکمه کپی برای برداشتن کد جهت گزارش باگ، تست یا مشخصات API استفاده کنید.