مستندات Genesis API

هرچه برای یکپارچه‌سازی لازم است: احراز هویت، محدودیت‌ها، اندپوینت‌ها و اسکیمای پاسخ.

مستنداتپلن‌ها و محدودیت‌ها

پلن‌ها و محدودیت‌ها

محدودیت‌ها را پلن تعیین می‌کند. وضعیت فعلی همیشه در /account/usage و در هدرهای هر پاسخ در دسترس است.

TrialStartProMax
فراخوانی در ماه500 هزار2 میلیون5 میلیون10 میلیون
درخواست در ثانیه12515
تازگی داده‌ها60 ثانیه30 ثانیه10 ثانیه5 ثانیه

اندپوینت‌های خارج از پلن، 403 با کد plan_restricted برمی‌گردانند. درخواست‌های فراتر از محدودیت هرگز محاسبه مالی نمی‌شوند.

فقط پاسخ 200 به‌عنوان یک فراخوانی حساب می‌شود. پاسخ‌های 304 (بدون تغییر) و خطاهای 4xx/5xx از سهمیه شما کم نمی‌کنند، اما در محدودیت درخواست در ثانیه شمرده می‌شوند.

حجم دانلود محدود است: حداکثر 60 MB داده فشرده در هر 10 ثانیه برای هر کلید. پایش همه مجموعه‌های داده با تازگی پلن شما با فاصله مطمئن در این محدوده می‌گنجد؛ پاسخ‌های کمتر از 64 KB شمرده نمی‌شوند. در صورت عبور از محدودیت — 429 download_limited تا پایان پنجره، و از سهمیه کسر نمی‌شود. با If-None-Match، فیلترها و پارامتر coin در ترافیک صرفه‌جویی کنید.

هدرهای محدودیت

هدرتوضیح
X-RateLimit-Limitحد درخواست در ثانیه برای پلن شما
X-RateLimit-Remainingدرخواست‌های باقی‌مانده در پنجره فعلی
X-RateLimit-Resetزمان unix ریست پنجره
X-Quota-Limitسهمیه فراخوانی دوره 30 روزه جاری
X-Quota-Remainingفراخوانی‌های باقی‌مانده در دوره
X-Quota-Resetزمان unix ریست سهمیه
Retry-Afterچند ثانیه صبر پیش از تکرار (با 429 و 503)