# Snelheidslimieten en gebruik

Inspecteer de capaciteit van de rekening, reageer op snelheidsgrenzen en track voltooid werk.

Canonische referentie: https://flashdata.dev/nl/docs/guides/usage-and-limits
Beoordeeld: 2026-11-04 door FlashData

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

## Controleer uw limieten

Grenzen volgen uw account en plan. Voer deze gratis controle met de sleutel die het werk zal indienen; alle sleutels op de rekening delen dezelfde capaciteit.

### CLI

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

#### Gratis account leest

```bash
flashdata account limits
```

- [Een sleutel instellen](https://flashdata.dev/nl/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Vereist Bash en cURL 7.76+. Sla de verborgen sleutelprompt over als uw omgeving al FLASHDATA_API_KEY levert. Voer de leesopdrachten uit in dezelfde terminal.

#### De sleutel instellen · overslaan indien reeds ingesteld

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

#### Lees 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

Sla de verborgen sleutelprompt over als FLASHDATA_API_KEY al is ingesteld. Voer de leesopdrachten uit in dezelfde terminal.

#### De sleutel instellen · overslaan indien reeds ingesteld

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

#### Lees 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>

### Begrijp elke limiet

Begin met één vluchtaanvraag en verhoog dan binnen de aangegeven grenzen. HTTP lees eindpunten en trialregistratie hebben ook hun eigen tarieflimieten; deze capaciteitsvelden zijn geen aanvragen-per-minute quota.

| Veld | Betekenis |
| --- | --- |
| limits.concurrency | Plan plafond voor gelijktijdige werkzaamheden, geen telling van gratis slots. |
| limits.batchSize | Maximaal aantal stuks in één partij. |
| limits.pendingJobs | Maximale hangende banen voor de rekening. |
| current.pendingJobs | In afwachting van het tellen op het moment van de lezing. Het kan veranderen voordat het wordt ingediend. |

- [Inschrijvingslimieten voor proeven](https://flashdata.dev/nl/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Een 429-respons hanteren

Lees de fouttekst en Retry-After-header. Om een gratis gelezen account te inspecteren, voer dit uit in een Bash terminal waar FLASHDATA_API_KEY is ingesteld. Headers zijn geschreven naar limits-headers.txt en de respons op limits.json.

### Status, headers en body vastleggen · 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>

### Wacht voor het opnieuw proberen

Dit voorbeeld betekent dat je minstens 60 seconden moet wachten. Retry-After kan ook een HTTP datum zijn. Gebruik de geretourneerde waarde, geen vaste vertraging.

#### Illustratieve responskoppen

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


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

### Kies de volgende actie

| Situatie | Actie |
| --- | --- |
| Capaciteit volledig | Verminder concurrency of wacht op lopende jobs tot finish. |
| Geen Retry-After | Gebruik afgetopte backoff met jitter en een eindige retry limiet. |
| Registratie beperkt | Wacht, probeer het dan opnieuw met hetzelfde profiel, invoer en bewijs. Niet van IP wisselen. |
| Indiening is verlopen | Inspecteer de bestaande run of taak voordat opnieuw in te dienen; het resultaat is onbekend. |

- [Herstellen van een onderbroken taak](https://flashdata.dev/nl/docs/guides/agent-recovery/reference.md)

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

## Gebruik van account lezen

Het standaard venster is de laatste zeven dagen. Gebruik omvat alle rekeningsleutels, beperkt tot de bronnen die deze sleutel kan openen.

### CLI

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

#### Gratis account leest

```bash
flashdata account usage
```

- [Een sleutel instellen](https://flashdata.dev/nl/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Hergebruik FLASHDATA_API_KEY van de eerdere controle in dezelfde terminal.

#### Lees 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

Hergebruik FLASHDATA_API_KEY van de eerdere controle in dezelfde terminal.

#### Lees 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>

### Controleer voltooid werk en credits

Lees totals en bySource en vergelijk from en to met je taakregistratie. CLI JSON plaatst het antwoord onder data. Recente verzoeken of terugbetalingen kunnen later zichtbaar worden, ook als updating false is.

#### Illustratief antwoord fragment

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

- [Inspecteer een taak in History](https://flashdata.dev/app/jobs)
- [Begrijp de kosten](https://flashdata.dev/nl/docs/guides/credits-and-billing/reference.md)

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

### Filter een bron- en datumbereik

Vervang de UTC-data door uw rapportageperiode, tot 31 dagen. van is inclusief en tot is exclusief; beide worden afgerond naar beneden tot minuten. Dit leest alleen bestaand gebruik.

#### Voorbeeld van rapportagevenster

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

