Überspringen zum Inhalt
DE
API-Schlüssel
Dokumentation durchsuchen

Erste Schritte

Tarifgrenzen und Nutzung

Ü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.

Kostenloses Konto liest
flashdata account limits

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.

FeldBedeutung
limits.concurrencyPlanen Sie die Decke für gleichzeitige Arbeit, nicht eine Anzahl von freien Slots.
limits.batchSizeMaximale Positionen in einer Charge.
limits.pendingJobsMaximale ausstehende Jobs für das Konto.
current.pendingJobsAusstehende 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.

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

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/1.1 429 Too Many Requests
Retry-After: 60

Wählen Sie die nächste Aktion

LageAktion
Volle KapazitätReduzieren Sie die Parallelität oder warten Sie auf ausstehende Jobs auf finish.
Nr. Retry-AfterVerwenden Sie ein gedeckeltes Backoff mit Jitter und einem endlichen Wiederholungslimit.
Registrierung beschränktWarten 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.

Kostenloses Konto liest
flashdata account usage

Ü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
{
  "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.

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