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

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

مرجع كانوني: https://flashdata.dev/ar/docs/guides/usage-and-limits
Reviewed: 2026-11-04 by FlashData

<a id="limits"></a>

## تحقق من حدودك

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

### CLI

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

#### الحساب الحر يقرأ

```bash
flashdata account limits
```

- [أُنشئ مفتاحاً](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Requires Bash and cURL 7.76+. تزلج على المفتاح المخفي إذا كانت البيئة الخاصة بك بالفعل إمدادات FLASHDATA_API_KEY. أديروا أوامر القراءة في نفس المحطة

#### تخطي إذا تم تشكيله بالفعل

```bash
# 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
```

#### الحساب الجاهز JSON

```bash
(
: "${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'
)
```


### PowerShell 7

قفزة المفتاح المخفي إذا FLASHDATA_API_KEY تم تحديده بالفعل. أديروا أوامر القراءة في نفس المحطة

#### تخطي إذا تم تشكيله بالفعل

```powershell
# 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
```

#### الحساب الجاهز JSON

```powershell
& {
  $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
}
```



<a id="capacity"></a>

### فهم كل حد

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

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

- [حدود تسجيل المحاكمات](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

## Handle a 429 response

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

### حالة الاستيعاب، والرؤس، والجسد: Bash/ cURL

```bash
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
```


<a id="retry-example"></a>

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

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

#### مؤيدو الاستجابة التوضيحية

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

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

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

- [استرداد مهمة مقاطعه](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

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

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

### CLI

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

#### الحساب الحر يقرأ

```bash
flashdata account usage
```

- [أُنشئ مفتاحاً](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

أعد استخدام FLASHDATA_API_KEY من الفحص السابق في الطرفية نفسها.

#### الحساب الجاهز JSON

```bash
(
: "${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'
)
```


### PowerShell 7

أعد استخدام FLASHDATA_API_KEY من الفحص السابق في الطرفية نفسها.

#### الحساب الجاهز JSON

```powershell
& {
  $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
}
```



<a id="usage-result"></a>

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

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

#### مقتطفات من الاستجابة التوضيحية

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [Inspect a job in History](https://flashdata.dev/app/jobs)
- [النفقات](https://flashdata.dev/ar/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

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

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

#### نافذة الإبلاغ

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

