حدود الاستخدام
تعرف على حدود استخدام API من ARASE لبيئات التطوير والإنتاج
حدود الاستخدام
تعرف على حدود استخدام API من ARASE لبيئات التطوير والإنتاج.
نقدم نوعين من حدود الاستخدام بناءً على البيئة المرتبطة بمفتاح API الخاص بك.
🔑 احصل على مفتاح API
أنشئ مفاتيح API للتطوير أو الإنتاج.
الباقات والأسعار
| الباقة | السعر/شهر | طلبات/شهر | طلبات/دقيقة |
|---|---|---|---|
Starter | مجاني | 100 | 10 |
Developer | 49 ر.س | 1,000 | 60 |
Professional | 199 ر.س | 5,000 | 120 |
Business | 499 ر.س | 20,000 | 300 |
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-Reset | Unix 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/شهر | الافتراضي للحسابات الجديدة |
| Developer | 49 ر.س/شهر | 1,000/شهر | ترقية في لوحة التحكم |
| Professional | 199 ر.س/شهر | 5,000/شهر | ترقية في لوحة التحكم |
| Business | 499 ر.س/شهر | 20,000/شهر | ترقية في لوحة التحكم |
| Enterprise | مخصص | غير محدود | تواصل معنا |
نصيحة: استخدم التخزين المؤقت (caching) لتقليل طلبات API والبقاء ضمن حدودك.
الأسئلة الشائعة
ماذا يحدث عند الوصول للحد الأقصى؟
ستحصل على استجابة 429 مع قيمة retryAfter تحدد المدة التي يجب انتظارها.
هل حدود الاستخدام لكل مفتاح أم لكل حساب؟
حدود الاستخدام تُطبق لكل مفتاح API. إذا كان لديك عدة مفاتيح، لكل منها حدوده الخاصة.
هل الطلبات الفاشلة تُحسب من حدي؟
نعم، جميع الطلبات (الناجحة أو الفاشلة) تُحسب من حد الاستخدام.
هل يمكنني التحقق من استخدامي الحالي؟
نعم! تحقق من header X-RateLimit-Remaining في أي استجابة API، أو شاهد استخدامك في لوحة التحكم.