# Batas rate dan penggunaan

Inspeksi kapasitas akun, menanggapi batas kecepatan dan jalur pekerjaan selesai.

Referensi kanonikal: https://flashdata.dev/id/docs/guides/usage-and-limits
Diulang: 2026-11-04 oleh FlashData

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

## Periksa batasanmu

Batas-batas mengikuti account dan rencana. Jalankan pemeriksaan gratis ini dengan kunci yang akan mengirimkan pekerjaan; semua kunci pada akun berbagi kapasitas yang sama.

### CLI

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

#### Rekening bebas dibaca

```bash
flashdata account limits
```

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

### Bash / cURL

Membutuhkan Bash dan cURL 7.76 +. Lewati prompt kunci tersembunyi jika lingkungan anda sudah menyediakan FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

#### Atur kunci bila 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
```

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

Lewati prompt kunci tersembunyi jika FLASHDATA_API_KEY telah diset. Jalankan perintah baca di terminal yang sama.

#### Atur kunci bila 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
```

#### Baca akun 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 batas masing-masing

Mulailah dengan satu permintaan in- penerbangan, kemudian meningkatkan dalam batas laporan. HTTP membaca titik akhir dan pendaftaran pengadilan juga memiliki batas tingkat sendiri; bidang kapasitas ini tidak diperlukan - kuota per menit.

| Ruas | Artinya |
| --- | --- |
| limits.concurrency | Rencana langit-langit untuk pekerjaan simultan, bukan hitungan slot bebas. |
| limits.batchSize | Butir maksimum dalam satu pengiriman batch. |
| limits.pendingJobs | Maksimum menunggu pekerjaan untuk account. |
| current.pendingJobs | Penundaan menghitung pada saat membaca. Ini bisa berubah sebelum penyerahan. |

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

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

## Tangani respon 429

Baca tubuh galat dan header Retry-After. Untuk memeriksa akun yang dibaca gratis, jalankan ini di terminal Bash dimana FLASHDATA_API_KEY diatur. Header ditulis ke limits-headers.txt dan respon terhadap limits.json.

### Menangkap status, tajuk dan tubuh 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 sebelum mencoba lagi

Contoh ini berarti tunggu setidaknya 60 detik. Retry-After bisa juga menjadi HTTP Kencan. Gunakan nilai kembali, bukan penundaan tetap.

#### Header respon Illustratif

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


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

### Pilih aksi berikutnya

| Situasi | Aksi |
| --- | --- |
| Kapasitas penuh | Mengurangi konkuensi atau menunggu pekerjaan yang tertunda untuk finish. |
| Tidak ada Retry-After | Gunakan backed off dengan jitter dan batas pengulangan terbatas. |
| Pendaftaran terbatas | Tunggu, coba lagi dengan profil, masukan dan bukti yang sama. Jangan beralih IP. |
| Waktu submisi habis | Inspeksi run atau pekerjaan yang telah ada sebelum mengajukan kembali; hasilnya tidak diketahui. |

- [Mengembalikan tugas yang diinterupsi](https://flashdata.dev/id/docs/guides/agent-recovery/reference.md)

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

## Baca penggunaan akun

Jendela baku adalah tujuh hari terakhir. Penggunaan mencakup semua kunci akun, dibatasi ke sumber yang kunci ini dapat mengakses.

### CLI

Gunakan disimpan Anda CLI Akses. Untuk profil bernama, tambahkan --profile NAMA ke setiap perintah. Baca ini jangan menghabiskan kredit query.

#### Rekening bebas dibaca

```bash
flashdata account usage
```

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

### Bash / cURL

Gunakan FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### Baca akun 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 FLASHDATA_API_KEY dari pemeriksaan sebelumnya di terminal yang sama.

#### Baca akun 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 pekerjaan dan kredit yang selesai

Baca total dan bySource, kemudian bandingkan dari dan ke dengan catatan tugas Anda. CLI JSON membungkus respon dalam data. Permintaan atau pengembalian dana baru-baru ini dapat mengambil waktu untuk muncul, bahkan ketika memperbarui adalah false.

#### Excerpt respon Illustratif

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

- [Inspeksi pekerjaan di History](https://flashdata.dev/app/jobs)
- [Memahami biaya](https://flashdata.dev/id/docs/guides/credits-and-billing/reference.md)

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

### Filter kisaran sumber dan tanggal

Ganti tanggal UTC dengan periode pelaporan Anda, hingga hari 31. Dari inklusif dan sampai eksklusif; keduanya dibulatkan ke menit. Ini hanya membaca penggunaan yang ada.

#### Contoh jendela pelaporan

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

