Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Domande frequenti e risoluzione dei problemi

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.

Leggi di account gratuito
flashdata --version
flashdata doctor --offline
flashdata auth status --json

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.

Individuare l'eseguibile
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 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à.

  1. 401: verificare la presenza di una chiave scaduta, revocata o non configurata. 403: confrontare la fonte richiesta con gli scopi dell'identità.
  2. 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.
Sostituisci e verifica una chiave del proprietario salvata
flashdata auth login --replace
flashdata auth status --json

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

Finire e verificare
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: 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.

Leggi di account gratuito
flashdata account balance
flashdata account pricing --source google_search --request-count 1

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.

Cattura la risposta · Bash / cURL / jq
# 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
)
Capacità del conto
flashdata account limits

400 / 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.

Convalida senza una presentazione pagata
flashdata query --input request.json --mode async --dry-run --json

In 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 erroreProssima azione
pending / processingAttendere lo stesso lavoro; non inviarlo di nuovo.
completedPrenda e salvi il risultato esistente.
failedIspezionare job.error prima di inviare il lavoro corretto.
404Controllare il lavoro ID e l'account di presentazione.
409I risultati non sono pronti. Continua a inquinare lo stesso lavoro.
410Archiviato JSON scaduto dopo le ore 24. Utilizzare la copia salvata; i supporti consegnati hanno la propria ritenzione di archiviazione.
Ispezione del lavoro salvato · Bash / jq
# 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
)
Ancora in esecuzione · utilizzare il JOB_ID restituito
flashdata jobs wait JOB_ID
Completato · utilizzare un nuovo nome file di output
flashdata jobs result JOB_ID --output recovered-result.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.

Ispezione prima · sostituire RUN_ID
flashdata runs show RUN_ID
Recuperare il lavoro accettato confermato
flashdata runs recover RUN_ID

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

Ispezionare la corsa originale
flashdata runs show RUN_ID

Ricerca vuota, didascalie mancanti o download illeggibile

Questi comandi leggono solo i file di risultato locali, non la busta stdout di CLI.

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

Controllare la configurazione
codex mcp list
Solo quando è richiesto il login OAuth
codex mcp login flashdata --scopes mcp:research

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

Controllare il pacchetto di abilità CLI predefinito
flashdata skills verify --agent codex

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

Acquisire un controllo gratuito di accesso CLI · Bash
flashdata auth status --json 2> diagnostic.json
Identificatori di errore dell'estratto · Bash / jq
# 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.json
Rapporto di sostegno
Ora 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: