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

Integrationen

Agenten-Authentifizierungsoptionen

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 dichVerwendungWer behält die Berechtigung?
Eine App, SDK, CLI oder ein geplantes SkriptBesitzer API SchlüsselSecret Store oder CLI-Profil Ihres Servers
Codex oder OpenClaw ForschungstoolsMCP OAuthDer Host nach Zustimmung des Browsers
Ein Agent, der FlashData ohne Konto versuchtTemporärer API-SchlüsselDas 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.

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

NachweiseVerfügbare Quellen
Besitzer API SchlüsselDie Quellen, die dem Schlüssel gewährt wurden, einschließlich youtube_download, wenn genehmigt.
Temporärer API-SchlüsselAusschließlich aus trial förderfähigen Quellen. Lesen Sie Scopes aus der aktuellen Identitätsantwort.
MCP OAuthgoogle_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.

Einmalige Einfuhr
flashdata auth login --profile research

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.

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'
)

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üfungErforderliches Ergebnis
Vorgesehenes KontoaccountId und apiKeyId identifizieren das Konto und den Schlüssel, den Sie verwenden möchten.
Nutzbarer Zugangaccess: ready
Aufgabenerlaubnisscopes enthält die Quelle, z. B. google_search. CLI listet auch die erlaubten Quellen in data.identity.permittedSources auf.
Wiederkehrende AufgabeaccountType: 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.

Vorübergehende Identität · illustrative Felder
{
  "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.

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

Sonde den Server
openclaw mcp doctor flashdata --probe

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

NachweiseFür die nächste Aufgabe
Besitzer API SchlüsselVerwenden Sie den gespeicherten Schlüssel wieder. Es hat keinen OAuth-Aktualisierungsschritt; Ersetzen Sie ihn, wenn er abgelaufen ist oder widerrufen wurde.
MCP OAuthDer 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üsselBeenden 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.

Frischprozess-Zugangskontrolle · Bash
(
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.

AnschlussWo zu widerrufen
MCP OAuthSettings → Connected apps → die App gewährt.
Beanspruchter Agent API SchlüsselSettings → Connected apps → Agentenverbindungen.
Konto API SchlüsselAPI Keys → der von dieser Integration verwendete Schlüssel.

Behebung einer fehlgeschlagenen Überprüfung

ErgebnisAktion
accessVerified: falseLesen 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: blockedStoppen 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: temporaryVerwenden 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: falseFü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_grantVerbinden 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, NullsaldoDie Authentifizierung funktionierte. Überprüfen Sie Billing vor bezahlter Arbeit; Ersetzen Sie keinen gültigen Schlüssel.