در این قسمت به بررسی محدودیتها و نحوه مدیریت درخواستها در 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 و رعایت محدودیتها میتواند عملکرد بهتر و پایدارتری را برای سیستم شما به همراه داشته باشد.