Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Integrazioni

Opzioni di autenticazione dell'agente

Collegare con una chiave API o MCP OAuth, verificare l'accesso senza una query a pagamento e riutilizzarlo per le attività successive.

In questa pagina

1. Scegliere e connettersi

Sei già connesso? Go direttamente al check-in gratuito 2. In caso contrario, scegliere l'accesso alle esigenze dell'applicazione o dell'agente.

Tu stai collegandoUsoChi tiene le credenziali?
Un'applicazione, SDK, CLI o script programmatoProprietario chiave APIIl negozio segreto del server o il profilo CLI
Strumenti di ricerca Codex o OpenClawMCP OAuthL'host dopo il consenso del browser
Un agente che prova FlashData senza un accountChiave temporanea APIIl profilo di prova salvato dell'agente, quindi l'accesso del proprietario dopo aver reclamato

Creare una chiave in API Keys con le fonti di cui hai bisogno, o riutilizzare una chiave esistente. Forniscilo al tuo SDK o invialo come X-API-Key dal tuo backend. Gli assegni Bash e PowerShell nel passaggio 2 funzionano direttamente con API; non è richiesta alcuna installazione CLI.

Quali fonti possono usare queste credenziali?

Utilizzare X-API-Key per normali richieste HTTP e connessioni API-chiave MCP. I gettoni portanti OAuth funzionano solo all'endpoint MCP ospitato. YouTube Download ha bisogno di una chiave API con youtube_download e storage di destinazione.

CredenzialiFonti disponibili
Proprietario chiave APILe fonti concesse alla chiave, incluso youtube_download quando approvato.
Chiave temporanea APISolo fonti di prova eleggibili. Leggi gli ambiti della risposta dell'identità corrente.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Salvare una chiave nella CLI

Salta l'importazione se CLI ha già accesso o il tuo manager segreto fornisce FLASHDATA_API_KEY. In caso contrario, scegliere un metodo qui sotto e mantenere lo stesso profilo di ricerca per i comandi successivi. Una chiave CLI salvata non è automaticamente disponibile per i server SDK o MCP locali.

Incolla la chiave al prompt dei terminali nascosti.

Importare una volta
flashdata auth login --profile research

2. Verificare la connessione

Eseguire il controllo gratuito nell'ambiente che eseguirà l'attività. I controlli CLI e HTTP utilizzano una chiave API; il controllo MCP utilizza la connessione salvata dell'host.

Richiede Bash e cURL 7.76+. Salta il prompt dei tasti nascosti se il tuo ambiente già fornisce FLASHDATA_API_KEY. Eseguire i comandi di lettura nello stesso terminale.

Impostare la chiave · saltare se già configurato
# 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
Leggi l'account 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'
)

Leggi l'identità API-chiave

I campi di identità HTTP sono al livello superiore. In CLI JSON, leggere data.identity.identity e richiedere data.accessVerified: true. HTTP 200 o CLI ok: true da solo non è sufficiente.

CheckRisultato richiesto
Conto intensoaccountId e apiKeyId identificano l'account e la chiave che si intende utilizzare.
Accesso utilizzabileaccess: ready
Permesso di attivitàgli ambiti contengono la fonte, come google_search. CLI elenca anche le fonti consentite in data.identity.permittedSources.
Attività ricorrenteaccountType: owned · installed: true · recurringAllowed: true

Una prova attiva è una connessione valida

Una prova può passare un controllo di attività uno-off mentre recurringAllowed è false. Leggere gli scopi e la scadenza effettivi; rivendicare il prova esistente prima della programmazione.

Identità temporanea · campi illustrativi
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Trova la connessione in Codex

Elenca i server configurati, quindi usa /mcp in una sessione Codex fresca. Eseguire il controllo MCP sopra per verificare le credenziali.

Elenco dei server
codex mcp list

Controllare la connessione in OpenClaw

Sondare il server salvato, quindi eseguire il controllo MCP sopra nella conversazione attiva.

Sonda il server
openclaw mcp doctor flashdata --probe

3. Riutilizzare l'accesso per le attività successive

Mantenere il negozio di credenziali privato e persistente attraverso riavviamenti di processo. Ricontrollare l'accesso in un processo fresco prima di abilitare il programmatore.

CredenzialiPer il prossimo compito
Proprietario chiave APIRiutilizzare la chiave salvata. Non ha alcun passo di aggiornamento OAuth; sostituirlo se scaduto o revocato.
MCP OAuthL'host aggiorna i token di accesso OAuth di un'ora utilizzando token di aggiornamento rotanti. Ricollegare quando la sovvenzione 90-day scade o viene revocata. Ogni installazione possiede il suo negozio di token; non condividere i file di aggiornamento-token tra gli host.
Chiave temporanea APITerminare il proprietario che reclama e le credenziali di consegna prima del lavoro ricorrente. Riutilizzare il profilo originale; non registrarsi di nuovo per ogni corsa.

Controllare un'attività CLI prima della pianificazione

Richiede Bash e jq. Impostare la FONTE alla fonte del compito. Lo script utilizza la ricerca per impostazione predefinita; impostare FLASHDATA_PROFILE e FLASHDATA_STATE_DIR per una directory diversa o di stato. Uscita 0 con identità JSON significa che la chiave del proprietario è pronta, installata e consentita per questa fonte. Fai smettere il programmatore su qualsiasi altra uscita. Nessuna domanda è presentata.

Controllo dell'accesso al processo fresco · 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}'
)

Se l'accesso è ancora una prova

Completare la guida di prova e rivendicazione con il profilo originale. Dopo l'approvazione del proprietario e la consegna delle credenziali, il controllo gratuito dovrebbe mostrare l'accesso di proprietà e recurringAllowed: true. Le richieste continue utilizzano il saldo condiviso del proprietario; i crediti di prova non utilizzati non trasferiscono. MCP OAuth login è una connessione separata e non richiede questo prova.

Accesso di fatturazione

Pausa che si occupa prima di tutto. Rivolgere le credenziali corrispondenti di seguito, quindi ripetere il controllo gratuito da un processo fresco o sessione prima di cancellare l'accesso locale. Aspettatevi un guasto dell'autenticazione o una richiesta di ricollegamento; non approvate una nuova connessione durante il controllo. Il logout locale non revoca l'accesso al server.

ConnessioneDove revocare
MCP OAuthSettings → Connected apps → sovvenzione dell'app.
Chiave dell'agente APISettings → Connected apps → Collegamenti agente.
Account chiave APIAPI Keys → la chiave utilizzata da questa integrazione.

Fissare un controllo fallito

RisultatoAzione
accessVerified: falseLeggere la fase e nextCommand. Un profilo in sospeso può restituire ok: true prima che una chiave sia utilizzabile. Terminare la registrazione o la richiesta salvata; conservare lo stesso profilo.
access: blockedSmettere anche se la risposta HTTP era 200. Verificare l'account o la connessione nella console; non trattare una risposta di identità come permesso di query.
accountType: temporaryUtilizzare la prova ammissibile per un lavoro di una tantum. Pretendiamolo prima della pianificazione; una nuova connessione OAuth non richiede questo profilo.
installed: falseDopo l'approvazione del proprietario, eseguire flashdata auth finish --wait con il profilo originale e la directory di stato. Allora ripeti l'assegno.
401 / invalid_grantRicollegare le credenziali scadute o revocate nel suo host originale. Non avviare un altro prova per bypassarlo.
403 / source_forbiddenControlla gli ambiti della chiave o l'elenco sorgente OAuth. YouTube Download utilizza un tasto API proprietario.
Accesso valido, saldo zeroL'autenticazione funziona. Controllare Billing prima del lavoro pagato; non sostituire una chiave valida.