# Batas laju dan penggunaan defakul

Mengespektasi kapasitas akun, merespon batas tarif dan pengerjaan jalur selesai.

Referensi boonical: https://flashdata.dev/ms/docs/guides/usage-and-limits
Diulas: 2026-11-04 oleh FlashData

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

## Periksa batasmu

Batas mengikuti rekening dan rencana Anda. Jalankan cek gratis ini dengan kunci yang akan menyerahkan pekerjaan; semua kunci pada akun berbagi kapasitas yang sama.

### CLI

Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.

#### Akun gratis dibaca

```bash
flashdata account limits
```

- [Sediakan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Kemudia membutuhkan Bash dan cURL 7.76+. Skip key propt tersembunyi jika lingkungan Anda sudah memasok FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

#### akun baca 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

Skip key prompt tersembunyi jika FLASHDATA_API_KEY sudah ditetapkan. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

#### akun baca 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>

### Memahami setiap batas

Mulailah dengan satu permintaan in-flight, kemudian peningkatan dalam batas yang dilaporkan. HTTP Eksekusi read read endpoints dan uji coba pendaftaran juga memiliki batas tarif sendiri; medan kapasitas ini bukan loper-per-minute kuota.

| Ukrainian | Arti |
| --- | --- |
| limits.concurrency | Skyle Plan patiles untuk kerja serentak, bukan hitungan slot bebas. |
| limits.batchSize | item maksimum dalam satu ketundukan kelompok. |
| limits.pendingJobs | Melewatkan pekerjaan yang tertunda secara maksimal untuk akun. |
| current.pendingJobs | Menghitung terulur pada waktu pembacaan. Ini bisa berubah sebelum menyerah. |

- [Batas pendaftaran percobaan](https://flashdata.dev/ms/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Handle sebuah respon 429

Dia membaca badan kesalahan dan Retry-After header. Untuk memeriksa akun gratis yang dibaca, jalankan ini di terminal Bash di mana FLASHDATA_API_KEY ditetapkan. Pengepala yang terkaji ditulis ke limits-headers.txt dan tanggapan terhadap limits.json.

### Status penangkapan, tajuk dan badan · 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>

### Tunggu dulu sebelum mencoba lagi

Contoh ini berarti tunggu setidaknya 60 detik. Retry-After juga dapat menjadi tanggal HTTP. Guna nilai yang dikembalikan, bukan penundaan tetap.

#### header respon Illustrative Illustrative

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


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

### Memilih tindakan berikutnya

| Situasi Orang Asing | Aksi |
| --- | --- |
| Kapasiti Penuh | Kurangi konkurensi atau tunggu untuk menunda pekerjaan ke finish. |
| Tak ada Retry-After | Use clocked backoff dengan ketaran dan batas coba ulang terbatas. |
| Pendaftaran terbatas | Tunggu, lalu coba lagi dengan profil yang sama, masukan dan bukti. Jangan beralih IP. |
| Submission Timed out | Periksa pelaksanaan atau pekerjaan yang ada sebelum mengajukan kembali; hasilnya tidak diketahui. |

- [Pulihkan tugas yang terganggu](https://flashdata.dev/ms/docs/guides/agent-recovery/reference.md)

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

## Penggunaan akun Bacaan

Jendela baku adalah tujuh hari terakhir. Kegunaan kesemua kunci akun, terbatas pada sumber kunci ini dapat mengakses.

### CLI

Gunakan CLI yang disimpan. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Bacaan ini tidak menghabiskan kredit pertanyaan.

#### Akun gratis dibaca

```bash
flashdata account usage
```

- [Sediakan kunci](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Gunakan ulang FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### akun baca 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

Gunakan ulang FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### akun baca 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>

### Periksa karya dan kredit yang telah selesai

Dan bySource, kemudian dibandingkan dari dan dengan catatan tugas Anda. CLI JSON Fifks membungkus respon dalam data. Permintaan atau pengembalian uang yang baru-baru ini diminta atau return dapat memakan waktu untuk muncul, bahkan ketika memperbarui adalah false.

#### Kutipan respon ilustrasi dan ilustrasi

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

- [Periksalah sebuah pekerjaan di History](https://flashdata.dev/app/jobs)
- [Mengerti tuduhan](https://flashdata.dev/ms/docs/guides/credits-and-billing/reference.md)

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

### Filter sebuah sumber dan jangkauan tanggal

Menggantikan tanggal UTC dengan periode pelaporan Anda, sampai dengan hari 31. dari adalah inklusif dan menjadi eksklusif; keduanya dibulatkan ke bawah ke menit. Ini hanya membaca penggunaan yang sudah ada.

#### Jendela pelaporan Contoh senam

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

