إنتقل إلى المحتوى الرئيسي

حدود المعدل

تطبق واجهة برمجة ArchiCore حدود المعدل لضمان الاستخدام العادل.

الحدود حسب المستوى​

المستوىالطلبات/يومالطلبات/دقيقةالمشاريع
مجاني100103
احترافي10,00010025
مؤسسيغير محدود1,000غير محدود

رؤوس حدود المعدل​

كل استجابة API تتضمن معلومات حدود المعدل:

HTTP/1.1 200 OK
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1640000000
الرأسالوصف
X-RateLimit-Limitالحد الأقصى للطلبات المسموحة
X-RateLimit-Remainingالطلبات المتبقية في النافذة
X-RateLimit-Resetطابع زمني Unix لإعادة ضبط الحد

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

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

HTTP/1.1 429 Too Many Requests
Retry-After: 60
{
  "success": false,
  "error": "تم تجاوز حد المعدل",
  "code": "RATE_LIMIT_EXCEEDED",
  "retryAfter": 60
}

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

1. تحقق من الرؤوس​

تحقق دائماً من X-RateLimit-Remaining قبل الطلبات:

async function makeRequest(url) {
  const response = await fetch(url, { headers });

  const remaining = response.headers.get('X-RateLimit-Remaining');
  if (parseInt(remaining) < 10) {
    console.warn('حد المعدل منخفض:', remaining);
  }

  return response.json();
}

2. تنفيذ التراجع الأسي​

async function requestWithRetry(url, maxRetries = 3) {
  for (let i = 0; i < maxRetries; i++) {
    const response = await fetch(url, { headers });

    if (response.status !== 429) {
      return response.json();
    }

    const retryAfter = response.headers.get('Retry-After') || 60;
    await sleep(retryAfter * 1000 * Math.pow(2, i));
  }

  throw new Error('تم تجاوز الحد الأقصى لإعادة المحاولة');
}

3. تخزين الاستجابات مؤقتاً​

خزّن الاستجابات لتقليل استدعاءات API:

const cache = new Map();

async function getCached(key, fetchFn, ttl = 60000) {
  const cached = cache.get(key);
  if (cached && Date.now() - cached.timestamp < ttl) {
    return cached.data;
  }

  const data = await fetchFn();
  cache.set(key, { data, timestamp: Date.now() });
  return data;
}

4. العمليات المجمعة​

استخدم نقاط النهاية المجمعة عند توفرها:

// بدلاً من طلبات متعددة
for (const id of projectIds) {
  await client.projects.get(id);  // ❌ طلبات متعددة
}

// استخدم نقطة النهاية المجمعة
await client.projects.getBatch(projectIds);  // ✓ طلب واحد

زيادة الحدود​

تحتاج حدوداً أعلى؟ ترقية إلى Pro أو اتصل بنا لخطط المؤسسات.