# Limiti di tasso e utilizzo

Ispezionare la capacità del conto, rispondere ai limiti di tasso e monitorare il lavoro completato.

Riferimento canonico: https://flashdata.dev/it/docs/guides/usage-and-limits
Recensito: 2026-11-04 da FlashData

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

## Controlla i tuoi limiti

I limiti seguono il tuo account e il tuo piano. Eseguire questo controllo gratuito con la chiave che invierà il lavoro; tutte le chiavi sul conto condividono la stessa capacità.

### CLI

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

#### Leggi di account gratuito

```bash
flashdata account limits
```

- [Impostare una chiave](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Richiede Bash e cURL 7.76+. Salta il prompt dei tasti nascosti se il tuo ambiente già fornisce FLASHDATA_API_KEY. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account 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

Salta il prompt dei tasti nascosti se FLASHDATA_API_KEY è già impostato. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account 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>

### Capire ogni limite

Iniziare con una richiesta in volo, quindi aumentare entro limiti segnalati. HTTP ha anche i limiti di velocità e la registrazione di prova; questi campi di capacità non sono quote di richiesta per minuto.

| Campo di applicazione | Significato |
| --- | --- |
| limits.concurrency | Piano soffitto per il lavoro simultaneo, non un conteggio di slot gratuite. |
| limits.batchSize | Elementi massimi in un'invio di lotti. |
| limits.pendingJobs | Lavori in sospeso per il conto. |
| current.pendingJobs | Contare i finanziamenti al momento della lettura. Può cambiare prima della presentazione. |

- [Limiti di registrazione di prova](https://flashdata.dev/it/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Gestire una risposta 429

Leggi il corpo di errore e l'intestazione Retry-After. Per ispezionare un account gratuito leggere, eseguire questo in un terminale Bash in cui è impostato FLASHDATA_API_KEY. Le intestazioni sono scritte a limits-headers.txt e la risposta a limits.json.

### Stato di cattura, intestazioni e corpo · 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>

### Attendere prima di riprovare

Questo esempio significa aspettare almeno i secondi 60. Retry-After può anche essere una data HTTP. Utilizzare il valore restituito, non un ritardo fisso.

#### Intestazioni di risposta illustrativa

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


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

### Scegli la prossima azione

| Situazione | Azione |
| --- | --- |
| Capacità piena | Ridurre la convalutazione o attendere i lavori in sospeso a finish. |
| No Retry-After | Utilizzare il backoff incassato con jitter e un limite di riprovazione finito. |
| Registrazione limitata | Attendere, poi riprovare con lo stesso profilo, input e prova. Non commutare gli IP. |
| La sottomissione si esaurisce | Ispezionare la corsa o il lavoro esistente prima di risottomettere; il suo risultato è sconosciuto. |

- [Recuperare un compito interrotto](https://flashdata.dev/it/docs/guides/agent-recovery/reference.md)

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

## Leggi l'utilizzo dell'account

La finestra di default è gli ultimi sette giorni. L'utilizzo copre tutte le chiavi dell'account, limitate alle fonti che questa chiave può accedere.

### CLI

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

#### Leggi di account gratuito

```bash
flashdata account usage
```

- [Impostare una chiave](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.

#### Leggi l'account 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

Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.

#### Leggi l'account 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>

### Controllare i lavori e i crediti completati

Leggi i totali e bySource, quindi confronta da e verso con i tuoi record di attività. CLI JSON avvolge la risposta nei dati. Le richieste recenti o i rimborsi possono richiedere il tempo di apparire, anche quando l'aggiornamento è false.

#### Estratto di risposta illustrativa

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

- [Ispezionare un lavoro in History](https://flashdata.dev/app/jobs)
- [Competenze](https://flashdata.dev/it/docs/guides/credits-and-billing/reference.md)

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

### Filtra un intervallo di sorgenti e date

Sostituire le date UTC con il periodo di segnalazione, fino a giorni 31. da è inclusivo e ad è esclusivo; entrambi sono arrotondati fino a minuti. Questo legge solo l'utilizzo esistente.

#### Esempio finestra di reportistica

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

