Sfoglia la documentazione
Per iniziare
Controllare l'accesso, risolvere una richiesta fallita o trovare una risposta sull'utilizzo di FlashData.
In questa pagina
Iniziare con un controllo di accesso gratuito
Eseguire l'assegno dove l'attività è fallita. Utilizzare le sue credenziali esistenti; questi comandi non inviano una query.
Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonUtilizzare l'attività esistente FLASHDATA_API_KEY nello stesso terminale, contenitore o lavoro programmato. Richiede cURL 7.76+.
(
: "${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'
)Utilizzare l'attività esistente FLASHDATA_API_KEY nello stesso terminale, contenitore o lavoro programmato.
& {
$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
}Cosa controllare
L'identità dovrebbe avere access: ready e includere la vostra fonte in ambiti. In CLI JSON, l'identità è a data.identity.identity; inoltre richiedono data.accessVerified: true. Un comando di successo con accessVerified: false non ha verificato l'accesso.
Per un profilo chiamato CLI, append --profile NAME ad ogni comando sottostante. Mantenere l'utente --state-dir originale e OS. FLASHDATA_API_KEY sovrascrive una chiave CLI salvata; Gli host SDK e MCP utilizzano la loro configurazione di credenziali.
Trovare e risolvere il problema
Apri il sintomo che corrisponde all'errore. Utilizzare IDs e ricevute dall'attività originale.
Comando non trovato o profilo mancante
Nessun eseguibile: installa il rilascio per il tuo OS/CPU e aggiungi la sua directory a PATH. Profilo mancante: utilizzare la directory utente e stato OS originale. Controlla anche il programmatore o il contenitore.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: chiave, portata o scadenza
Per sostituire una chiave del proprietario salvata, incollare la chiave approvata nel prompt nascosto. Se FLASHDATA_API_KEY è impostato, aggiornare il segreto nel runtime invece; salvare un'altra chiave CLI non lo sovrascriverà.
- 401: verificare la presenza di una chiave scaduta, revocata o non configurata. 403: confrontare la fonte richiesta con gli scopi dell'identità.
- REST e SDKs utilizzano X-API-Key. Un token MCP OAuth non può sostituire una chiave API. Per l'accesso temporaneo, utilizzare il recupero di reclamo qui sotto.
flashdata auth login --replace
flashdata auth status --jsonApprovazione del reclamo, ma l'agente ha ancora accesso al prova
Terminare il handoff nello stesso profilo CLI che ha creato il reclamo. Il proprietario completa la registrazione, la verifica e-mail e il consenso nel browser; lo CLI riceve le credenziali.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonRichiedete un nuovo link per la prova esistente, lasciate che il proprietario approvi, quindi fate funzionare auth finish. Non eseguire di nuovo init.
flashdata auth claim402: crediti insufficienti
Confronta availableCredits con il prezzo attuale per la tua fonte. Pretendiamo una prova esausto per utilizzare il saldo del proprietario, o lasciare che il proprietario rivedere Billing prima di riprovare.
Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.
flashdata account balance
flashdata account pricing --source google_search --request-count 1Utilizzare l'attività esistente FLASHDATA_API_KEY nello stesso terminale, contenitore o lavoro programmato. Richiede cURL 7.76+.
(
: "${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/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)Utilizzare l'attività esistente FLASHDATA_API_KEY nello stesso terminale, contenitore o lavoro programmato.
& {
$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/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: attendere prima di riprovare
Leggi Retry-After sulla risposta fallita: secondi o una data HTTP. Attendere fino ad allora e ridurre la convalutazione. La registrazione di prova consente tre registrazioni per IP per 24-ora finestra; riutilizzare il profilo originale e la prova di registrazione.
Questa lettura libera dimostra di salvare intestazioni, stato e corpo. Utilizzare lo Retry-After dall'operazione che non è riuscita; i limiti di query, registrazione e lettura account possono differire.
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400 / 422: ingressi o guasti di elaborazione rifiutati
Leggi codice, dettaglio e fieldErrors dall'errore HTTP. Correggere il corpo della richiesta, salvarlo come request.json, quindi convalidarlo. Conservare le credenziali di archiviazione Download in un file di input privato. Se 422 proviene dal risultato di un lavoro esistente, ispezionare prima job.error.
flashdata query --input request.json --mode async --dry-run --jsonIn attesa di lavoro, o HTTP 200 con un lavoro fallito
Leggi il lavoro da submission.json, la ricevuta asinclinata salvata. HTTP 200 significa che lo stato letto è riuscito; job.status è l'esito dell'attività (data.status in CLI JSON). Per Batch, salvare l'entrata pertinente da query come submission.json.
| Stato o errore | Prossima azione |
|---|---|
| pending / processing | Attendere lo stesso lavoro; non inviarlo di nuovo. |
| completed | Prenda e salvi il risultato esistente. |
| failed | Ispezionare job.error prima di inviare il lavoro corretto. |
| 404 | Controllare il lavoro ID e l'account di presentazione. |
| 409 | I risultati non sono pronti. Continua a inquinare lo stesso lavoro. |
| 410 | Archiviato JSON scaduto dopo le ore 24. Utilizzare la copia salvata; i supporti consegnati hanno la propria ritenzione di archiviazione. |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)Timeout / 5xx: è stato accettato il compito?
Ispezionare il run originale e History prima di riproporre un POST. Recuperare un lavoro accettato confermato. Se l'accettazione è sconosciuta, mantenere l'esecuzione ID e il supporto di contatto; cambiare IDs e resubmitting può duplicare le accuse.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: il file di risultato esiste già
Lo CLI non sovrascrive i file --output. Leggi il file esistente, o scegli un nuovo nome file di output mantenendo l'originale --run-id e la richiesta. Non inventare una nuova esecuzione ID per bypassare questo errore.
flashdata runs show RUN_IDRicerca vuota, didascalie mancanti o download illeggibile
Questi comandi leggono solo i file di risultato locali, non la busta stdout di CLI.
Se lo stato è fatto e organico è vuoto, allentare i filtri di query. Tenere il risultato vuoto nel vostro record di attività.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonI metadati elencano i codici di lingua, non se una traccia è manuale o automatica. Scegli una lingua elencata e imposta l'auto esplicitamente: true per automatico, false per manuale. Nessuna traccia di corrispondenza significa niente didascalie per quella selezione; FlashData non genera un sostituto.
jq '.results[0].transcriptLanguages' metadata.jsonLeggi la ricevuta completa di delivery.json. Scarica l'oggetto con le credenziali di destinazione-storage, quindi confronta le sue dimensioni e MD5 con la ricevuta. Una file_url privata non diventa pubblica dopo la consegna.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonStrumenti MCP mancanti o l'autenticazione scaduta
Controllare l'host che esegue l'operazione. Un server elencato conferma la configurazione, non una connessione di lavoro. Se la connessione OAuth configurata richiede il login, eseguire il comando di login e l'approvazione completa del browser, quindi aggiornare l'elenco degli strumenti.
Aprire /mcp nello Codex CLI per controllare lo stato e gli strumenti di connessione. Nell'app, controllare il server configurato e avviare una sessione nuova dopo le modifiche di configurazione.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeIl login OAuth non ripara una connessione API-chiave. Controllare la chiave nell'ambiente dell'host e le sue autorizzazioni di origine. Per lo stdio locale, controllare il requisito MCP del pacchetto Node.js e riavviare l'host dopo l'aggiornamento del suo ambiente.
node --versionCompetere installato ma l'agente non riesce a trovarlo o utilizzarlo
Controllare lo stesso progetto, il profilo host e installare la posizione, quindi avviare una sessione di agente fresco. Le competenze di compito CLI hanno bisogno di CLI; flashdata-mcp ha bisogno di un server MCP collegato. L'installazione di un'abilità non collega un server o concede le autorizzazioni dell'account.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkDomande frequenti
Collegamento
Mi serve un agente dell'AI?
No. Utilizzare il HTTP API, Go/Python/TypeScript SDK, CLI o la console direttamente. MCP e le competenze sono opzioni aggiuntive per gli agenti.
Quale interfaccia dovrei scegliere?
Utilizzare un SDK o HTTP API all'interno di un'app, CLI per le attività terminali, e MCP per un host MCP-capable. Le abilità forniscono istruzioni per le attività CLI o gli strumenti MCP collegati; non sostituiscono l'autenticazione.
Posso riutilizzare le credenziali per i compiti ricorrenti?
Si'. Utilizzare l'accesso del proprietario e preservare lo stesso profilo CLI protetto, il segreto runtime o la connessione MCP. Per l'accesso API-chiave, controllare recurringAllowed: true. Il vostro ospite o programmatore gestisce il programma.
Eliminare le impostazioni locali revocare l'accesso?
No. Rivolgere la chiave o la connessione API nella console. Cancellare le impostazioni locali rimuove solo quella copia locale.
Prova e crediti
Può un agente provare FlashData prima dell'iscrizione?
Sì, con accesso temporaneo idoneo tramite CLI o a bordo API. Riutilizzare lo stesso profilo e la prova di registrazione. L'uso continuato ha bisogno di rivendicazione o di una chiave API esistente.
Dice di aggiungere un'altra borsa di studio?
Rivendicarsi non concede crediti extra di prova. Le richieste future utilizzano il saldo del conto del proprietario; i crediti temporanei non utilizzati non trasferiscono. Un conto appena creato segue la normale politica di accreditamento.
Quante richieste possono coprire i miei crediti?
Controlla il saldo del conto e i prezzi delle fonti. I conteggi delle richieste dipendono dalla fonte e le attività di risorse miste condividono un unico equilibrio. YouTube Il download è valutato da byte scaricate, non da un numero di richieste fisso.
Fonti e risultati
Perché il mio agente può cercare ma non scaricare?
Scarica le esigenze di accesso al proprietario, autorizzazione youtube_download e archiviazione di destinazione. Le prove temporanee e mcp:research OAuth non includono Download. Una chiave API autorizzata può essere utilizzata tramite CLI, HTTP o MCP.
Google Cerca le pagine web complete di reso?
restituisce i risultati di ricerca e gli estratti. La tua app o agente legge la URLs selezionata.
FlashData genera sintesi video o didascalie?
Recupera metadati e didascalie esistenti. Non genera didascalie mancanti; il vostro modello scrive un riassunto dai risultati disponibili.
Ancora bloccata? Invia un report minimo
Salvare il corpo di errore HTTP o l'errore CLI JSON da stderr come diagnostic.json. Estrarre gli identificatori solo dopo un comando fallito. Tenere le chiavi, testo di query privato e firmato URLs fuori dal rapporto. Per le risposte non JSON, segnalare lo stato HTTP da diagnostic-status.txt.
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonOra UTC:
Client + versione:
Fonte + stadio (auth / inviare / sondaggio / fetch):
HTTP stato + codice di errore:
Richiesta ID / lavoro ID / eseguire ID:
Risultato della sottomissione: accettato / rifiutato / sconosciuto
Preveduto vs risultato effettivo: