# Tarifgrenzen und Nutzung

Überprüfen Sie die Kontokapazität, reagieren Sie auf Tariflimits und verfolgen Sie abgeschlossene Arbeiten.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/usage-and-limits
Test: 2026-11-04 von FlashData

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

## Überprüfen Sie Ihre Limits

Limits folgen Ihrem Konto und Plan. Führen Sie diesen kostenlosen Scheck mit dem Schlüssel aus, der die Arbeit einsendet; alle Schlüssel auf dem Konto teilen sich die gleiche Kapazität.

### CLI

Verwenden Sie Ihren gespeicherten CLI-Zugang. Für ein benanntes Profil, anhängen --profile NAME zu jedem Befehl. Diese Reads geben keine Abfrage-Credits aus.

#### Kostenloses Konto liest

```bash
flashdata account limits
```

- [Einrichten eines Schlüssels](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Erfordert Bash und cURL 7.76+. Überspringen Sie die versteckte Tastenaufforderung, wenn Ihre Umgebung bereits FLASHDATA_API_KEY bereitstellt. Führen Sie die Lesebefehle im selben Terminal aus.

#### Schlüssel einstellen · Überspringen, wenn bereits konfiguriert

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

#### Lesen Sie das Konto 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

Überspringen Sie die versteckte Tastenaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist. Führen Sie die Lesebefehle im selben Terminal aus.

#### Schlüssel einstellen · Überspringen, wenn bereits konfiguriert

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

#### Lesen Sie das Konto 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>

### Verstehen Sie jedes Limit

Beginnen Sie mit einer In-Flight-Anfrage und erhöhen Sie dann innerhalb der gemeldeten Limits. HTTP Leseendpunkte und Testregistrierung haben auch ihre eigenen Tarifgrenzen; diese Kapazitätsfelder sind keine Anforderungs-pro-Minute-Kontingente.

| Feld | Bedeutung |
| --- | --- |
| limits.concurrency | Planen Sie die Decke für gleichzeitige Arbeit, nicht eine Anzahl von freien Slots. |
| limits.batchSize | Maximale Positionen in einer Charge. |
| limits.pendingJobs | Maximale ausstehende Jobs für das Konto. |
| current.pendingJobs | Ausstehende Zählung zum Zeitpunkt des Lesens. Es kann sich vor der Einreichung ändern. |

- [Grenzwerte für die Versuchsregistrierung](https://flashdata.dev/de/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Behandeln Sie eine 429 Antwort

Lesen Sie den Fehlerkörper und den Retry-After-Header. Um ein kostenloses Konto zu lesen, führen Sie dies in einem Bash-Terminal aus, in dem FLASHDATA_API_KEY eingestellt ist. Header werden in limits-headers.txt geschrieben und die Antwort auf limits.json.

### Erfassungsstatus, Kopfzeilen und Körper · 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>

### Warten Sie, bevor Sie es erneut versuchen

Dieses Beispiel bedeutet, mindestens 60 Sekunden zu warten. Retry-After kann auch ein HTTP Datum sein. Verwenden Sie den zurückgegebenen Wert, keine feste Verzögerung.

#### Illustrative Response-Header

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


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

### Wählen Sie die nächste Aktion

| Lage | Aktion |
| --- | --- |
| Volle Kapazität | Reduzieren Sie die Parallelität oder warten Sie auf ausstehende Jobs auf finish. |
| Nr. Retry-After | Verwenden Sie ein gedeckeltes Backoff mit Jitter und einem endlichen Wiederholungslimit. |
| Registrierung beschränkt | Warten Sie, dann versuchen Sie es mit dem gleichen Profil, Eingabe und Beweis. Wechseln Sie keine IPs. |
| Einreichungsfrist abgelaufen | Überprüfen Sie den bestehenden Lauf oder Job, bevor Sie erneut einreichen; sein Ergebnis ist unbekannt. |

- [Wiederherstellen einer unterbrochenen Aufgabe](https://flashdata.dev/de/docs/guides/agent-recovery/reference.md)

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

## Nutzung des Lesekontos

Das Standardfenster sind die letzten sieben Tage. Die Verwendung umfasst alle Kontoschlüssel, beschränkt auf die Quellen, auf die dieser Schlüssel zugreifen kann.

### CLI

Verwenden Sie Ihren gespeicherten CLI-Zugang. Für ein benanntes Profil, anhängen --profile NAME zu jedem Befehl. Diese Reads geben keine Abfrage-Credits aus.

#### Kostenloses Konto liest

```bash
flashdata account usage
```

- [Einrichten eines Schlüssels](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Verwenden Sie FLASHDATA_API_KEY aus dem früheren Check im selben Terminal wieder.

#### Lesen Sie das Konto 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

Verwenden Sie FLASHDATA_API_KEY aus dem früheren Check im selben Terminal wieder.

#### Lesen Sie das Konto 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>

### Überprüfen Sie abgeschlossene Arbeiten und Credits

Lesen Sie Summen und bySource und vergleichen Sie dann von und zu Ihren Aufgabenaufzeichnungen. CLI JSON wickelt die Antwort in Daten ein. Aktuelle Anfragen oder Rückerstattungen können einige Zeit in Anspruch nehmen, auch wenn die Aktualisierung false ist.

#### Beschreibung des Reaktionsauszugs

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

- [Überprüfen Sie einen Job in History](https://flashdata.dev/app/jobs)
- [Gebühren verstehen](https://flashdata.dev/de/docs/guides/credits-and-billing/reference.md)

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

### Filtern einer Quelle und Datumsbereich

Ersetzen Sie die UTC-Daten durch Ihren Berichtszeitraum, bis zu 31-Tagen. von ist inklusive und bis ist exklusiv; beide werden auf Minuten abgerundet. Dies liest nur die bestehende Nutzung.

#### Beispiel-Berichtsfenster

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

