پرش به محتوای اصلی
یک شروع رایگان برای شما

۳ روز رایگان،
پنل تحلیلگر را تجربه کنید

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

✓ بدون نیاز به پرداخت✓ فعال‌سازی پس از تأیید موبایل
شروع رایگان ۳ روزه

ویژه کاربران جدید · یک دوره برای هر حساب

خطای 429 در API اخبار؛ تشخیص سهمیه و طراحی تلاش مجدد

وضعیت 429 یعنی درخواست‌ها با یک محدودیت مصرف مواجه شده‌اند. علت دقیق را باید از پاسخ و مستندات سرویس فهمید. این وضعیت الزاماً به معنای نامعتبر بودن کلید نیست.

تیم khapi · ۲۰ آبان ۱۴۰۵ · ۳ دقیقه مطالعه
تصویر مفهومی نمای مفهومی صف درخواست‌ها مقابل دریچه کنترل‌شده سرور

معنای خطای 429

وضعیت 429 یعنی درخواست‌ها با یک محدودیت مصرف مواجه شده‌اند. علت دقیق را باید از پاسخ و مستندات سرویس فهمید. این وضعیت الزاماً به معنای نامعتبر بودن کلید نیست. تکرار فوری می‌تواند همان خطا را دوباره ایجاد کند. نخست نوع محدودیت و زمان امکان ادامه را تشخیص دهید.

نرخ با سهمیه فرق دارد

محدودیت نرخ به تعداد درخواست در یک پنجره زمانی مربوط است. سهمیه روزانه یا ماهانه، بودجه مصرف دوره را محدود می‌کند. توقف کوتاه ممکن است نرخ لحظه‌ای را اصلاح کند. اما پایان سهمیه دوره با چند ثانیه انتظار حل نمی‌شود. رفتار مصرف‌کننده باید این دو حالت را از هم جدا کند.

خواندن پاسخ بدون فرض

کد HTTP را پیش از تبدیل بدنه بررسی کنید. بدنه خطا ممکن است JSON یا محتوای دیگری باشد. توضیح قابل استفاده را بدون ثبت کلید استخراج کنید. اگر سرور Retry-After فرستاده، آن را بررسی کنید. وجود این هدر در همه پاسخ‌های 429 تضمین نشده است.

دو شکل زمان انتظار

مقدار Retry-After می‌تواند مدت انتظار یا یک تاریخ HTTP باشد. در حالت تاریخ، اختلاف زمان با ساعت فعلی را محاسبه کنید. ساعت سیستم مصرف‌کننده باید قابل اتکا باشد. مقدار نامعتبر نیازمند مسیر جایگزین محدود است. زمان انتظار را با سقف عملیاتی برنامه هماهنگ کنید.

تلاش مجدد کنترل‌شده

برای خطای موقت، فاصله تلاش‌ها را به‌تدریج افزایش دهید. اندکی پراکندگی زمانی از شروع هم‌زمان چند مصرف‌کننده می‌کاهد. تعداد تلاش و حداکثر زمان کل را محدود کنید. پس از رسیدن به سقف، خطا باید آشکار باقی بماند. حلقه بی‌پایان راهکار بازیابی قابل اعتماد نیست.

نمودار توضیحی سه کارت تلاش با فاصله زمانی رو به افزایش روی خط زمان

کاهش درخواست اضافی

نتیجه یکسان را برای مصرف‌کنندگان متعدد دوباره دریافت نکنید. کش کوتاه‌مدت سمت خودتان می‌تواند مناسب باشد. فیلترها و اندازه صفحه را متناسب با کار تنظیم کنید. تعداد خبر با تعداد درخواست قابل صورتحساب یکسان نیست. ابتدا الگوی مصرف را ثبت کنید تا علت فشار مشخص شود.

چند کلید و چند کارگر

تکثیر کلید برای دور زدن محدودیت راه‌حل درستی نیست. کارگرهای یک برنامه باید بودجه مصرف مشترک را بشناسند. محدودیت ممکن است به حساب یا طرح وابسته باشد. هم‌زمانی کنترل‌نشده می‌تواند تمام کارها را متوقف کند. صف مشترک و سقف اجرا، برنامه‌ریزی را قابل پیش‌بینی‌تر می‌کند.

آزمون بدون فشار واقعی

پاسخ 429 را در آزمون با داده ساختگی شبیه‌سازی کنید. حالت دارای هدر، بدون هدر و تاریخ نامعتبر را بررسی کنید. مطمئن شوید تعداد تلاش از سقف عبور نمی‌کند. پایان سهمیه باید به توقف قابل توضیح منجر شود. برای آزمودن خطا، سرویس واقعی را عمداً زیر بار نبرید.

ثبت برای عیب‌یابی

زمان، مسیر درخواست و دسته خطا را نگه دارید. شمار تلاش‌ها و زمان انتظار برای تحلیل مفید هستند. هدر کلید و اطلاعات حساس را حذف کنید. افزایش خطا را با زمان‌بندی کارهای جدید مقایسه کنید. این شواهد گفت‌وگو با پشتیبانی را دقیق‌تر می‌کنند.

بررسی در khapi

محدودیت طرح و وضعیت مصرف حساب khapi را بررسی کنید. نام پارامترهای درخواست را با مستندات تطبیق دهید. اگر مصرف غیرمنتظره است، اجراهای تکراری را پیدا کنید. جزئیات پاسخ را بدون رازهای حساب برای بررسی نگه دارید. راه‌حل باید علت مصرف را اصلاح کند، نه فقط خطا را پنهان سازد.

منابع و ادامه مطالعه

اشتراک‌گذاری:

این مطلب چطور به کار شما بیاید؟

مفاهیم این مقاله را مستقیم در پنل khapi امتحان کنید:

آماده شروع هستید؟

۳ روز استفادهٔ رایگان از پنل تحلیلگر، مطابق محدودیت‌های دورهٔ آزمایشی و بدون نیاز به کارت بانکی.