حدود المعدّل والترويسات

يمكن لكل مفتاح API إرسال 120 طلبًا في الدقيقة. يُحتسب الحد ضمن نوافذ مدة كل منها دقيقة واحدة، ويشمل جميع نقاط النهاية، بما فيها الطلبات التي تعيد خطأً. وعندما تُستنفد النافذة، تُرفض الطلبات التالية بالحالة 429 وبرمز الخطأ rate_limited إلى أن تبدأ نافذة جديدة.

هل تحتاج إلى حدود أعلى أو أسعار للكميات الكبيرة؟ تواصل مع فريق المبيعات.

ترويسات حد المعدّل#

تحمل كل استجابة لطلب مصادَق عليه حالة نافذتك:

لا تحمل هذه الترويسات الطلبات المرفوضة بسبب مفتاح مفقود أو غير صالح (401).

async function call(url, init) {  for (let attempt = 0; attempt < 5; attempt++) {    const response = await fetch(url, init);    if (response.status !== 429) return response;    const wait = Number(response.headers.get("retry-after")) || 1;    await new Promise((resolve) => setTimeout(resolve, wait * 1000));  }  throw new Error("Rate limited");}

import time def call(method, url, **kwargs):    for attempt in range(5):        response = requests.request(method, url, **kwargs)        if response.status_code != 429:            return response        time.sleep(int(response.headers.get("retry-after", 1)))    raise RuntimeError("Rate limited")

وزّع ذروات الطلبات على الزمن، وفضّل Webhooks على حلقات الاستعلام المتكرر الكثيفة، واستخدم Prefer: wait في التحليلات بدلًا من الاستعلام المتكرر. وعندما تكون السعة المتاحة مستخدمة بالكامل، يعيد POST /analyses الاستجابة 503 service_unavailable مع retry-after؛ راجع عندما تكون السعة المتاحة مستخدمة بالكامل.

ترويسات الاستجابة الأخرى#

الترويسات التي ترسلها#

• Authorization: Bearer <key>: مطلوبة. راجع المصادقة والمفاتيح.
• Content-Type: application/json لطلبات JSON؛ وmultipart/form-data لعمليات الرفع عبر POST /files.
• Idempotency-Key: اختيارية، في طلبات POST.
• Prefer: wait=N: اختيارية، في POST /analyses.

مثال: يعرض curl -i https://api.fileverity.com/v1/models -H "Authorization: Bearer $FILEVERITY_API_KEY" جميع ترويسات الاستجابة.