تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

البدء

الحد من المعدل واستخدامه

(ج) فحص قدرة الحسابات، والاستجابة لمحدودية المعدلات، وتتبع الأعمال المنجزة.

في هذه الصفحة

تحقق من حدودك

الحدود تتبع حسابك وخطتك إجراء هذا الشيك الحر مع المفتاح الذي سيقدم العمل؛ وجميع مفاتيح الحساب تتقاسم نفس القدرة.

إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار

الحساب الحر يقرأ
flashdata account limits

فهم كل حد

ابدأ بطلب واحد في الرحلة ثم التزايد في الحدود المبلغ عنها وتقرأ HTTP نقاط نهاية وتسجيل المحاكمات أيضا حدود معدلاتها الخاصة؛ ولا تشكل مجالات القدرة هذه حصصا لكل دقيقة.

الميدانمعنى
limits.concurrencyحد أقصى للخطة للعمل المتزامن، وليس عدد من الأماكن المجانية.
limits.batchSizeالحد الأقصى من المواد في ورقة واحدة
limits.pendingJobsالحد الأقصى للوظائف المعلقة للحساب.
current.pendingJobsحتى العد وقت القراءة ويمكن أن تتغير قبل تقديم التقرير.

Handle a 429 response

اقرأي الجسم الخطأ Retry-After رأس. لتفتيش حساب مجاني، تشغيل هذا في محطة Bash حيث يتم تحديد FLASHDATA_API_KEY. ويُكتب العنوان إلى limits-headers.txt والرد على limits.json.

حالة الاستيعاب، والرؤس، والجسد: Bash/ cURL
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}" \
  --dump-header limits-headers.txt --output limits.json \
  --write-out 'HTTP %{http_code}\n' \
  https://api.flashdata.dev/v2/api-access/limits
cat limits-headers.txt limits.json

انتظر قبل إعادة التجفيف

وهذا المثال يعني الانتظار على الأقل 60 ثواني. ويمكن أيضا أن يكون زيك زكسكسك (Retry-After) تاريخا من تاريخ HTTP. استخدم القيمة العائدة، وليس تأخيراً ثابتاً.

مؤيدو الاستجابة التوضيحية
HTTP/1.1 429 Too Many Requests
Retry-After: 60

اختر الإجراء التالي

الحالةالإجراء
القدرات الكاملةقلّل التزامن أو انتظر انتهاء المهام المعلّقة.
No Retry-Afterاستعملوا البقايا المكبوتة مع الجليس والحد الأقصى للبقايا
التسجيل المحدودمهلاً، ثمّ نُعيد النظر في نفس الملفّات، والمدخلات والإثباتات. لا تبديل شركاء التنفيذ.
وقت تقديم الطلبافحص التشغيل أو المهمة الموجودة قبل إعادة الإرسال؛ فالنتيجة غير معروفة.

استخدام حساب القراءة

نافذة الفشل هي آخر سبعة أيام الأمتعة تغطي جميع مفاتيح الحسابات، مقصورة على المصادر التي يمكن لهذا المفتاح الوصول إليها.

إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار

الحساب الحر يقرأ
flashdata account usage

العمل المنجز والائتمانات

اقرأ totals وbySource، ثم قارن from وto بسجلات مهامك. يغلّف CLI JSON الاستجابة داخل data. قد تتأخر الطلبات الحديثة أو عمليات الاسترداد في الظهور، حتى عندما تكون updating بقيمة false.

مقتطفات من الاستجابة التوضيحية
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

:: إعداد مجموعة من المصادر والتاريخ

يستعاض عن تواريخ مركز التجارة في الولايات المتحدة بفترة الإبلاغ التي تصل إلى أيام " 31 " ، من تاريخ الشمولية إلى آخره؛ وكلتاهما مقسمتان إلى دقائق. ويقرأ هذا الاستخدام الحالي فقط.

نافذة الإبلاغ
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"