أريز Docs

حدود الاستخدام

تعرف على حدود استخدام API من ARASE لبيئات التطوير والإنتاج

حدود الاستخدام

تعرف على حدود استخدام API من ARASE لبيئات التطوير والإنتاج.

نقدم نوعين من حدود الاستخدام بناءً على البيئة المرتبطة بمفتاح API الخاص بك.

🔑 احصل على مفتاح API

أنشئ مفاتيح API للتطوير أو الإنتاج.


الباقات والأسعار

الباقةالسعر/شهرطلبات/شهرطلبات/دقيقة
Starterمجاني10010
Developer49 ر.س1,00060
Professional199 ر.س5,000120
Business499 ر.س20,000300
Enterpriseتواصل معناغير محدود1,000

لشحن رصيد إضافي، استخدم باقات الشحن لإضافة طلبات لحسابك.


Headers حدود الاستخدام

كل استجابة API تتضمن معلومات حدود الاستخدام في الـ headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1699999999
Headerالوصف
X-RateLimit-Limitالحد الأقصى للطلبات المسموحة في الدقيقة
X-RateLimit-Remainingالطلبات المتبقية في النافذة الحالية
X-RateLimit-ResetUnix timestamp عندما يتم إعادة ضبط الحد

التعامل مع تجاوز الحد

عند تجاوز حد الاستخدام، ستحصل على استجابة 429 Too Many Requests:

{
  "error": "Rate limit exceeded",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 30,
  "message": "Please wait 30 seconds before retrying"
}

أفضل الممارسات

استخدم exponential backoff - عند استلام 429، انتظر وأعد المحاولة مع زيادة التأخير.

async function searchWithRetry(query: string, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    try {
      return await arase.search(query);
    } catch (error) {
      if (error.code === "RATE_LIMIT_EXCEEDED") {
        const delay = Math.pow(2, i) * 1000; // 1s, 2s, 4s
        await new Promise((r) => setTimeout(r, delay));
      } else {
        throw error;
      }
    }
  }
  throw new Error("Max retries exceeded");
}

ترقية باقتك

تحتاج رصيد أكثر؟ إليك خياراتك:

الباقةالسعرالرصيدكيف تحصل عليها
Starterمجاني100/شهرالافتراضي للحسابات الجديدة
Developer49 ر.س/شهر1,000/شهرترقية في لوحة التحكم
Professional199 ر.س/شهر5,000/شهرترقية في لوحة التحكم
Business499 ر.س/شهر20,000/شهرترقية في لوحة التحكم
Enterpriseمخصصغير محدودتواصل معنا

نصيحة: استخدم التخزين المؤقت (caching) لتقليل طلبات API والبقاء ضمن حدودك.


الأسئلة الشائعة

ماذا يحدث عند الوصول للحد الأقصى؟

ستحصل على استجابة 429 مع قيمة retryAfter تحدد المدة التي يجب انتظارها.

هل حدود الاستخدام لكل مفتاح أم لكل حساب؟

حدود الاستخدام تُطبق لكل مفتاح API. إذا كان لديك عدة مفاتيح، لكل منها حدوده الخاصة.

هل الطلبات الفاشلة تُحسب من حدي؟

نعم، جميع الطلبات (الناجحة أو الفاشلة) تُحسب من حد الاستخدام.

هل يمكنني التحقق من استخدامي الحالي؟

نعم! تحقق من header X-RateLimit-Remaining في أي استجابة API، أو شاهد استخدامك في لوحة التحكم.

في هذه الصفحة