تصفح الوثائق
البدء
(ج) فحص قدرة الحسابات، والاستجابة لمحدودية المعدلات، وتتبع الأعمال المنجزة.
في هذه الصفحة
تحقق من حدودك
الحدود تتبع حسابك وخطتك إجراء هذا الشيك الحر مع المفتاح الذي سيقدم العمل؛ وجميع مفاتيح الحساب تتقاسم نفس القدرة.
إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار
flashdata account limitsRequires Bash and cURL 7.76+. تزلج على المفتاح المخفي إذا كانت البيئة الخاصة بك بالفعل إمدادات FLASHDATA_API_KEY. أديروا أوامر القراءة في نفس المحطة
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/limits' || exit
printf '\n'
)قفزة المفتاح المخفي إذا FLASHDATA_API_KEY تم تحديده بالفعل. أديروا أوامر القراءة في نفس المحطة
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/limits"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}فهم كل حد
ابدأ بطلب واحد في الرحلة ثم التزايد في الحدود المبلغ عنها وتقرأ HTTP نقاط نهاية وتسجيل المحاكمات أيضا حدود معدلاتها الخاصة؛ ولا تشكل مجالات القدرة هذه حصصا لكل دقيقة.
| الميدان | معنى |
|---|---|
| limits.concurrency | حد أقصى للخطة للعمل المتزامن، وليس عدد من الأماكن المجانية. |
| limits.batchSize | الحد الأقصى من المواد في ورقة واحدة |
| limits.pendingJobs | الحد الأقصى للوظائف المعلقة للحساب. |
| current.pendingJobs | حتى العد وقت القراءة ويمكن أن تتغير قبل تقديم التقرير. |
Handle a 429 response
اقرأي الجسم الخطأ Retry-After رأس. لتفتيش حساب مجاني، تشغيل هذا في محطة Bash حيث يتم تحديد FLASHDATA_API_KEY. ويُكتب العنوان إلى limits-headers.txt والرد على limits.json.
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أعد استخدام FLASHDATA_API_KEY من الفحص السابق في الطرفية نفسها.
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/usage' || exit
printf '\n'
)أعد استخدام FLASHDATA_API_KEY من الفحص السابق في الطرفية نفسها.
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/usage"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}العمل المنجز والائتمانات
اقرأ 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"