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