خطای HTTP 429 Too Many Requests
HTTP 429 Too Many Requests کد وضعیتی است که سرور وقتی برمیگرداند که کلاینت در مدت کوتاه درخواستهای زیادی فرستاده و به محدودیت نرخ (rate limit) خورده است. این کد در سال 2012 در RFC 6585 معرفی شد. استاندارد نمیگوید درخواستها چگونه شمرده شوند: به ازای هر کلید، آدرس IP یا منبع، در ثانیه یا در ساعت؛ بنابراین هر سرویس قواعد خودش را دارد.
نحوهٔ مدیریت 429
این تابع اسپرد فاندینگ را درخواست میکند و پس از پاسخهای 429 و 503 دوباره تلاش میکند:
import os
import time
import requests
URL = "https://api.genesisarbitrage.com/v1/funding/spread"
HEADERS = {"X-API-Key": os.environ["GENESIS_API_KEY"]}
def get_with_retry(params, attempts=5):
delay = 1
for _ in range(attempts):
r = requests.get(URL, headers=HEADERS,
params=params, timeout=10)
if r.status_code not in (429, 503):
r.raise_for_status()
return r.json()["data"]
wait = r.headers.get("Retry-After", "")
# وقفهٔ سرور اگر داده شده، وگرنه 1، 2، 4… ثانیه
time.sleep(int(wait) if wait.isdigit() else delay)
delay = min(delay * 2, 60)
raise RuntimeError("still rate limited: poll less often")
rows = get_with_retry({"min_spread": 0.05})
print("coins with a funding spread of 0.05% or more:", len(rows))
دو برابر کردن وقفه exponential backoff نام دارد. تلاش مجدد بدون وقفه به احتمال زیاد دوباره 429 میگیرد. اگر چند نسخه از ربات درخواست میفرستند، به هر وقفه کسر تصادفی از ثانیه اضافه کنید تا تلاشهای مجدد آنها همزمان نرسند.
429 در Genesis API
Genesis API کد 429 را با یکی از دو کد در بدنهٔ پاسخ و هدر Retry-After برمیگرداند:
| کد | چه زمانی | چه کنیم |
|---|---|---|
rate_limited | عبور از محدودیت درخواست در ثانیه: از 1 در Trial تا 15 در Max | تا پایان Retry-After صبر کنید و درخواستها را در زمان پخش کنید |
download_limited | بیش از 60 مگابایت داده فشرده در هر 10 ثانیه برای هر کلید | تا پایان پنجره صبر کنید و درخواست را با فیلترها و coin محدود کنید |
{
"success": false,
"error": {
"code": "rate_limited",
"message": "Requests per second limit exceeded."
}
}
درخواستهای بیش از محدودیت هرگز صورتحساب نمیشوند: فقط پاسخ 200 یک فراخوانی حساب میشود و 429 مانند هر خطای دیگر از سهمیهٔ شما کم نمیکند. با این حال خطاها در محدودیت درخواست در ثانیه شمرده میشوند، پس تلاشهای مجدد سریع 429 تازه میآورند. هدر X-RateLimit-Remaining باقیماندهٔ پنجرهٔ فعلی و X-Quota-Remaining باقیماندهٔ سهمیه را نشان میدهد.
همچنین ببینید: پولینگ API، ETag و If-None-Match، خطاها در مستندات Genesis API، محدودیتهای Genesis API.
پرسش و پاسخ
429 چه فرقی با 503 دارد؟
429 یعنی بیش از حد درخواست میدهید. در Genesis API، 503 با کد snapshot_not_ready یعنی داده در حال بازسازی است یا منبع آن دوباره راهاندازی میشود: بعد از Retry-After ثانیه دوباره تلاش کنید.
چرا با وجود درخواستهای کم ربات 429 میگیرم؟
محدودیت به ازای هر کلید است، پس دو اسکریپت با یک کلید یک محدودیت را تقسیم میکنند. علت دیگر دانلودهای کامل مکرر بدون فیلتر است که به سقف حجم download_limited میخورند.