Dokumentation durchsuchen
Integrationen
Verbinden Sie sich mit einem API-Schlüssel oder MCP OAuth, überprüfen Sie den Zugriff ohne bezahlte Abfrage und verwenden Sie ihn für spätere Aufgaben.
Auf dieser Seite
1. Wählen und verbinden
Schon vernetzt? Gehen Sie direkt zum kostenlosen Check in Schritt 2. Andernfalls wählen Sie den Zugriff, den Ihre Anwendung oder Ihr Agent benötigt.
| Du verbindest dich | Verwendung | Wer behält die Berechtigung? |
|---|---|---|
| Eine App, SDK, CLI oder ein geplantes Skript | Besitzer API Schlüssel | Secret Store oder CLI-Profil Ihres Servers |
| Codex oder OpenClaw Forschungstools | MCP OAuth | Der Host nach Zustimmung des Browsers |
| Ein Agent, der FlashData ohne Konto versucht | Temporärer API-Schlüssel | Das gespeicherte Testprofil des Agenten, dann Zugriff des Eigentümers nach Beanspruchung |
Erstellen Sie einen Schlüssel in API Keys mit den Quellen, die Ihre Aufgabe benötigt, oder verwenden Sie einen vorhandenen Schlüssel wieder. Liefern Sie es an Ihr SDK oder senden Sie es als X-API-Key von Ihrem Backend. Die Bash- und PowerShell-Prüfungen in Schritt 2 arbeiten direkt mit dem API; es ist keine CLI-Installation erforderlich.
Verwenden Sie einen Host, der für FlashData OAuth konfiguriert ist. Der Kontoinhaber schließt die Anmeldung oder Anmeldung und Zustimmung im Browser ab; der Host speichert die Token. Diese Verbindung installiert keinen CLI-Schlüssel oder beansprucht eine Testversion.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchFür einen Agenten ohne Schlüssel, discover die aktuelle Testberechtigung vor der Registrierung. Wiederverwendung einer bestehenden Studie und ihres Profils. YouTube Download und wiederkehrende Aufgaben erfordern den Zugriff des Besitzers.
flashdata discover --profile research --jsonWelche Quellen kann diese Credential verwenden?
Verwenden Sie X-API-Key für normale HTTP-Anfragen und API-Schlüssel-MCP-Verbindungen. OAuth Bearer Token funktionieren nur am gehosteten MCP Endpunkt. YouTube Download benötigt einen Besitzer-API-Schlüssel mit youtube_download und Zielspeicher.
| Nachweise | Verfügbare Quellen |
|---|---|
| Besitzer API Schlüssel | Die Quellen, die dem Schlüssel gewährt wurden, einschließlich youtube_download, wenn genehmigt. |
| Temporärer API-Schlüssel | Ausschließlich aus trial förderfähigen Quellen. Lesen Sie Scopes aus der aktuellen Identitätsantwort. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Speichern Sie einen Schlüssel im CLI
Überspringen Sie den Import, wenn der CLI bereits Zugriff hat oder Ihr Geheimmanager FLASHDATA_API_KEY liefert. Andernfalls wählen Sie eine Methode unten und halten Sie das gleiche Forschungsprofil für spätere Befehle. Ein gespeicherter CLI-Schlüssel ist nicht automatisch für SDKs oder lokale MCP-Server verfügbar.
Fügen Sie den Schlüssel in die versteckte Terminal-Eingabeaufforderung ein.
flashdata auth login --profile researchSetzen Sie FLASHDATA_KEY_FILE auf den Pfad einer vorhandenen geschützten Schlüsseldatei. Der Befehl liest es über stdin; halten Sie den Schlüssel aus dem Chat und Befehl Argumente.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"2. Überprüfen Sie die Verbindung
Führen Sie den kostenlosen Check in der Umgebung aus, in der die Aufgabe ausgeführt wird. CLI und HTTP verwenden einen API-Schlüssel; der MCP-Check verwendet die eigene gespeicherte Verbindung des Hosts.
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.
# 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/identity' || 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/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Verwenden Sie das OS-Benutzer-, Profil- und Zustandsverzeichnis aus dem Login. Ersetzen Sie die Recherche, wenn Sie ein anderes Profil verwenden; fügen Sie bei Bedarf --state-dir PATH hinzu. FLASHDATA_API_KEY überschreibt den gespeicherten Schlüssel. Erwarten Sie ok: true und data.accessVerified: true; dann überprüfen Sie die Identitätsfelder unten.
flashdata auth status --profile research --json --non-interactiveSenden Sie dies an eine neue Sitzung Ihres verbundenen Agenten. Ersetzen Sie google_search durch die Quelle, die Ihre Aufgabe benötigt. Erwarten Sie, dass beide Tool-Aufrufe erfolgreich sind; Überprüfen Sie die Preisgestaltung und den Saldo vor der bezahlten Arbeit separat. Ein gelisteter Server allein überprüft den Zugriff nicht.
Verwenden Sie die vorhandene Flashdata MCP-Verbindung.
Rufen Sie get_pricing mit {"source":"google_search","request_count":1} an.
Rufen Sie get_balance mit {} an.
Geben Sie an, ob beide Anrufe erfolgreich waren, ob die Quelle einen verfügbaren Preis hat;
und den verfügbaren Kreditsaldo. Ein Nullsaldo ist kein Authentifizierungsfehler.
Führen Sie keine Suche aus oder laden Sie sie herunter, erstellen Sie eine Testversion oder ändern Sie Ihre Anmeldeinformationen.Lesen Sie die API-Schlüsselidentität
HTTP-Identitätsfelder befinden sich auf der obersten Ebene. In CLI JSON lesen Sie data.identity.identity und benötigen data.accessVerified: true. HTTP 200 oder CLI ok: true allein ist nicht genug.
| Überprüfung | Erforderliches Ergebnis |
|---|---|
| Vorgesehenes Konto | accountId und apiKeyId identifizieren das Konto und den Schlüssel, den Sie verwenden möchten. |
| Nutzbarer Zugang | access: ready |
| Aufgabenerlaubnis | scopes enthält die Quelle, z. B. google_search. CLI listet auch die erlaubten Quellen in data.identity.permittedSources auf. |
| Wiederkehrende Aufgabe | accountType: owned · installed: true · recurringAllowed: true |
Eine aktive Testversion ist eine gültige Verbindung
Eine Testversion kann eine einmalige Aufgabenüberprüfung bestehen, während recurringAllowed false ist. Lesen Sie die tatsächlichen Umfange und Ablauf; fordern Sie die bestehende Studie vor der Planung der Arbeit.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Finden Sie die Verbindung in Codex
Listen Sie konfigurierte Server auf und verwenden Sie dann /mcp in einer neuen Codex-Sitzung. Führen Sie die MCP-Prüfung oben aus, um die Berechtigung zu überprüfen.
codex mcp listÜberprüfen Sie die Verbindung in OpenClaw
Sondieren Sie den gespeicherten Server und führen Sie dann den MCP-Check oben in Ihrer aktiven Konversation aus.
openclaw mcp doctor flashdata --probe3. Wiederverwendung des Zugriffs für spätere Aufgaben
Halten Sie den Credential Store privat und persistent über Prozessneustarts hinweg. Überprüfen Sie den Zugriff in einem neuen Prozess erneut, bevor Sie Ihren Scheduler aktivieren.
| Nachweise | Für die nächste Aufgabe |
|---|---|
| Besitzer API Schlüssel | Verwenden Sie den gespeicherten Schlüssel wieder. Es hat keinen OAuth-Aktualisierungsschritt; Ersetzen Sie ihn, wenn er abgelaufen ist oder widerrufen wurde. |
| MCP OAuth | Der Host aktualisiert eine Stunde OAuth-Zugriffstoken mit rotierenden Refresh-Token. Verbinden Sie sich erneut, wenn der 90-Tageszuschuss abläuft oder widerrufen wird. Jede Installation besitzt ihren Token-Store; Teilen Sie keine Refresh-Token-Dateien zwischen Hosts. |
| Temporärer API-Schlüssel | Beenden Sie den Besitzer, der vor wiederkehrenden Arbeiten Anspruch auf und die Übergabe von Nachweisen geltend macht. Verwenden Sie das ursprüngliche Profil wieder; registrieren Sie sich nicht für jeden Lauf erneut. |
Überprüfen Sie eine CLI-Aufgabe vor der Planung
Erfordert Bash und jq. Setzen Sie die Quelle auf die Quelle der Aufgabe. Das Skript verwendet standardmäßig research; legen Sie FLASHDATA_PROFILE und FLASHDATA_STATE_DIR für ein anderes Profil oder Zustandsverzeichnis fest. Exit 0 mit Identität JSON bedeutet, dass der Besitzerschlüssel für diese Quelle bereit, installiert und zugelassen ist. Lassen Sie Ihren Scheduler bei jedem anderen Ausgang anhalten. Es wird keine Anfrage eingereicht.
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi
flashdata auth status "${args[@]}" |
jq -e --arg source "$SOURCE" '
select(.ok == true and .data.accessVerified == true)
| .data.identity as $auth
| $auth.identity
| select(.accountType == "owned" and .access == "ready"
and .installed == true and .recurringAllowed == true
and ((.scopes // []) | index($source) != null)
and (($auth.permittedSources // []) | index($source) != null))
| {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)Wenn der Zugang immer noch eine Testversion ist
Füllen Sie den Test- und Anspruchsleitfaden mit dem Originalprofil aus. Nach der Genehmigung des Eigentümers und der Übergabe der Anmeldeinformationen sollte der kostenlose Check den eigenen Zugriff und recurringAllowed: true anzeigen. Fortgesetzte Anfragen verwenden das geteilte Guthaben des Eigentümers; nicht verwendete Testkredite werden nicht übertragen. MCP OAuth Login ist eine separate Verbindung und beansprucht diese Testversion nicht.
Zugang widerrufen
Unterbrechen Sie wiederkehrende Jobs zuerst. Widerrufen Sie den untenstehenden übereinstimmenden Berechtigungsnachweis und wiederholen Sie dann den kostenlosen Check aus einem neuen Prozess oder einer neuen Sitzung, bevor Sie den lokalen Zugriff löschen. Erwarten Sie einen Authentifizierungsfehler oder eine Reconnect-Anforderung; genehmigen Sie keine neue Verbindung während der Überprüfung. Lokale Anmeldung allein widerruft den Serverzugriff nicht.
| Anschluss | Wo zu widerrufen |
|---|---|
| MCP OAuth | Settings → Connected apps → die App gewährt. |
| Beanspruchter Agent API Schlüssel | Settings → Connected apps → Agentenverbindungen. |
| Konto API Schlüssel | API Keys → der von dieser Integration verwendete Schlüssel. |
Behebung einer fehlgeschlagenen Überprüfung
| Ergebnis | Aktion |
|---|---|
| accessVerified: false | Lesen Sie Phase und nextCommand. Ein ausstehendes Profil kann ok: true zurückgeben, bevor ein Schlüssel verwendet werden kann. Beenden Sie die gespeicherte Registrierung oder den Anspruch; behalten Sie das gleiche Profil bei. |
| access: blocked | Stoppen Sie, auch wenn die HTTP-Antwort 200 war. Überprüfen Sie das Konto oder die Verbindung in der Konsole; behandeln Sie eine Identitätsantwort nicht als Abfrageberechtigung. |
| accountType: temporary | Verwenden Sie die förderfähige Studie für einmalige Arbeiten. Fordern Sie es vor der Planung an; eine neue OAuth-Verbindung beansprucht dieses Profil nicht. |
| installed: false | Führen Sie nach Genehmigung des Eigentümers Flashdaten auth finish --wait mit dem Originalprofil und dem Statusverzeichnis aus. Dann wiederholen Sie die Überprüfung. |
| 401 / invalid_grant | Verbinden Sie den abgelaufenen oder widerrufenen Nachweis in seinem ursprünglichen Host. Beginnen Sie keine weitere Studie, um es zu umgehen. |
| 403 / source_forbidden | Überprüfen Sie die Schlüsselbereiche oder die OAuth-Quellliste. YouTube Download verwendet einen Besitzer API Schlüssel. |
| Gültiger Zugang, Nullsaldo | Die Authentifizierung funktionierte. Überprüfen Sie Billing vor bezahlter Arbeit; Ersetzen Sie keinen gültigen Schlüssel. |