مستندات Genesis API
هرچه برای یکپارچهسازی لازم است: احراز هویت، محدودیتها، اندپوینتها و اسکیمای پاسخ.
پلنها و محدودیتها
محدودیتها را پلن تعیین میکند. وضعیت فعلی همیشه در /account/usage و در هدرهای هر پاسخ در دسترس است.
| Trial | Start | Pro | Max | |
|---|---|---|---|---|
| فراخوانی در ماه | 500 هزار | 2 میلیون | 5 میلیون | 10 میلیون |
| درخواست در ثانیه | 1 | 2 | 5 | 15 |
| تازگی دادهها | 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) |