توثيق 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)