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

Erste Schritte

Header und Authentifizierung

Verwenden Sie den richtigen Host und Zugangsnachweis und prüfen Sie den Zugriff mit einer kostenlosen Anfrage.

Auf dieser Seite

Basis URLs

ZweckBasis URLAuthentifizierung
Datenanfragen und Jobshttps://data.flashdata.dev/v1X-API-Key
Identität, Saldo, Preis, Limits und Nutzunghttps://api.flashdata.dev/v2X-API-Key
Fernbedienung MCPhttps://data.flashdata.dev/mcpHost-managed OAuth oder X-API-Key

Authentifizierungs-Header

REST-Anfragen verwenden X-API-Key mit einem Test- oder Besitzerschlüssel. Senden Sie JSON-Körper mit Content-Type: application/json. CLI-Profile, SDK-Umgebungen und MCP-Verbindungen speichern Anmeldeinformationen separat.

Request Headers (Anfrage-Header)
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

Überprüfen Sie Ihren Schlüssel

Führen Sie dies in Ihrem Terminal aus. Der Identitätsendpunkt überprüft den Zugriff, ohne Credits auszugeben. Überspringen Sie die Tastenaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist.

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: 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
(
: "${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/identity' || exit
printf '\n'
)

Erwartete Antwort

Erwarten Sie HTTP 200. Überprüfen Sie das beabsichtigte Konto, access: ready und Ihre Quelle in Scopes. Ein temporärer Schlüssel hat accountType: temporary; wiederkehrende Besitzerarbeit erfordert recurringAllowed: true.

Eigentümeridentität · illustrative Antwort Auszug
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

Signierter Speicher URLs

Ergebnis und Upload URLs enthalten ihre eigene Autorisierung. Folgen Sie dem zurückgegebenen URL ohne X-API-Key, OAuth Token oder Browser-Cookies.

Authentifizierung von Fehlerbehebungen

AntwortNächster Schritt
401Überprüfen Sie den Schlüssel in dieser Umgebung, seinen Ablauf und Widerruf. Verwenden Sie einen aktuellen API-Schlüssel, nicht ein MCP-Token oder ein Bearer-Präfix.
403 / Quelle fehltBitten Sie den Besitzer, die erforderliche Quelle für diesen Schlüssel zu gewähren.
503 auf diesem kostenlosen LesenVersuchen Sie das Lesen später. Der Kontostatus wurde nicht verifiziert; folgern Sie nicht, dass eine bezahlte Abfrage bereit ist.