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