توثيق Genesis API

كل ما تحتاجه للتكامل: المصادقة والحدود ونقاط النهاية ومخططات الاستجابة.

التوثيقالأخطاء

الأخطاء

الأخطاء تعيد حالة HTTP المناسبة مع جسم:

json
{
  "success": false,
  "error": {
    "code": "rate_limited",
    "message": "Requests per second limit exceeded."
  }
}
HTTPالرمزالوصف
400bad_requestمعاملات الطلب غير صالحة — التفاصيل في message
401invalid_keyالمفتاح غائب أو غير صالح أو ملغى، أو انتهت صلاحية اشتراك API
403plan_restrictedنقطة النهاية ليست ضمن خطتك
404not_foundنقطة النهاية أو المورد غير موجود
410goneنقطة النهاية متوقفة — البديل في message
429rate_limitedتجاوز الحد — راجع X-RateLimit وRetry-After
429download_limitedتم تجاوز حجم التنزيل: 60 MB من البيانات المضغوطة لكل 10 ثوانٍ لكل مفتاح — راجع Retry-After
500internal_errorخطأ داخلي، أعد المحاولة لاحقاً
503snapshot_not_readyيجري إعادة بناء البيانات أو إعادة تشغيل مصدرها — أعد المحاولة بعد بضع ثوانٍ، راجع Retry-After

كل استجابة تحمل الترويسة X-Request-Id. عند التواصل مع الدعم أرسلها مع وقت الطلب بتوقيت UTC والنقطة النهائية والحالة — ولا ترسل مفتاحك أبداً.