Dokumentation durchsuchen
Erste Schritte
Überprüfen Sie die Kontokapazität, reagieren Sie auf Tariflimits und verfolgen Sie abgeschlossene Arbeiten.
Auf dieser Seite
Ü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.
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.
flashdata account limitsErfordert 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.
# 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(
: "${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'
)Überspringen Sie die versteckte Tastenaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist. Führen Sie die Lesebefehle im selben Terminal aus.
# 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& {
$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
}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. |
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.
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.jsonWarten 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.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Wä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. |
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.
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.
flashdata account usageVerwenden Sie FLASHDATA_API_KEY aus dem früheren Check im selben Terminal wieder.
(
: "${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'
)Verwenden Sie FLASHDATA_API_KEY aus dem früheren Check im selben Terminal wieder.
& {
$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
}Ü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.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}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.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"