0

محدودیت‌های درخواست (Rate Limits)

  • مستندات API

در این قسمت به بررسی محدودیت‌ها و نحوه مدیریت درخواست‌ها در API Rasmio می‌پردازیم. برای جلوگیری از سوءاستفاده یا فشار بیش از حد به سرور، این API دارای محدودیت‌های خاصی است که در هنگام استفاده باید به آن‌ها توجه شود.

API Rasmio دارای محدودیت تعداد درخواست‌ها در هر دقیقه است. این محدودیت‌ها به‌گونه‌ای طراحی شده‌اند که سرورها به درستی پاسخگوی نیاز کاربران باشند و عملکرد API برای همه کاربران بهینه باقی بماند.

جزئیات محدودیت‌ها:

  • حداکثر تعداد درخواست‌ها: هر کاربر مجاز است تا 300 درخواست در هر دقیقه ارسال کند.
  • اگر تعداد درخواست‌ها از این حد فراتر رود، API خطای 429 Too Many Requests را برمی‌گرداند.

پاسخ‌های مرتبط با محدودیت‌ها:

در هر پاسخ API، یک سری هدرها (Headers) وجود دارد که اطلاعات مرتبط با محدودیت‌ها را به شما نمایش می‌دهند:

Header توضیح
X-TodayLimit حداکثر تعداد درخواست‌های مجاز روزانه
X-UsedToday تعداد درخواست‌های استفاده شده در روز جاری
X-TotalLimit حداکثر تعداد درخواست طبق قرارداد
X-UsedTotal تعداد کل درخواست‌های استفاده شده

خطای 429 – Too Many Requests

اگر تعداد درخواست‌های شما از حد مجاز فراتر رود، خطای زیر را دریافت خواهید کرد:

{
    "status": 429,
    "traceId": "00-0ba137d74251b06f6d6c6a68a822a711-dd736a8125d57de8-00"
}

نحوه کنترل محدودیت‌ها:

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

پاسخ 503 – Service Unavailable

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


نتیجه‌گیری:

در این قسمت با محدودیت‌های درخواست‌ها (Rate Limits) و نحوه مدیریت آن‌ها آشنا شدید. استفاده بهینه از API و رعایت محدودیت‌ها می‌تواند عملکرد بهتر و پایدار‌تری را برای سیستم شما به همراه داشته باشد.

دسته‌بندی‌ها
  • مستندات API