Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Veelgestelde vragen en probleemoplossing

Controleer uw toegang, repareer een mislukt verzoek of vind een antwoord over het gebruik van FlashData.

Op deze pagina

Begin met een gratis toegangscontrole

Voer de controle uit waar de taak mislukt is. Gebruik de bestaande referenties; deze commando's geven geen query.

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

Gratis account leest
flashdata --version
flashdata doctor --offline
flashdata auth status --json

Wat te controleren

De identiteit moet access: ready hebben en uw bron in scopes opnemen. In CLI JSON is de identiteit data.identity.identity; ook data.accessVerified: true vereist. Een succesvol commando met accessVerified: false heeft geen toegang geverifieerd.

Voor een CLI profiel met de naam, voeg --profile NAAM toe aan elk commando hieronder. Houd de originele --state-dir en OS gebruiker. FLASHDATA_API_KEY overschrijft een opgeslagen CLI-sleutel; SDK's en MCP hosts gebruiken hun eigen credential configuratie.

Het probleem zoeken en oplossen

Open het symptoom dat overeenkomt met uw fout. Gebruik IDs en ontvangstbewijzen van de oorspronkelijke taak.

Opdracht niet gevonden of profiel ontbreekt

Geen uitvoerbaar bestand: installeer de release voor uw OS/CPU en voeg de directory toe aan PATH. Ontbrekend profiel: gebruik de originele OS-gebruiker en statusmap. Controleer ook in de planner of container.

Het uitvoerbare bestand lokaliseren
command -v flashdata
flashdata --version
flashdata doctor --offline

401 / 403: sleutel, toepassingsgebied of vervaldatum

Om een opgeslagen eigenaarsleutel te vervangen, plak de goedgekeurde sleutel in de verborgen prompt. Als FLASHDATA_API_KEY is ingesteld, update dat geheim in de runtime in plaats daarvan; het opslaan van een andere CLI sleutel zal het niet overschrijven.

  1. 401: controleer op een verlopen, ingetrokken of verkeerd geconfigureerde sleutel. 403: vergelijk de gevraagde bron met de scopes van de identiteit.
  2. REST en SDK gebruiken X-API-Key. Een MCP OAuth token kan een API sleutel niet vervangen. Voor tijdelijke toegang, gebruik de claim recuperatie hieronder.
Een opgeslagen eigenaarsleutel vervangen en verifiëren
flashdata auth login --replace
flashdata auth status --json

Claim goedgekeurd, maar de agent heeft nog steeds toegang tot een proces.

Voltooi de overdracht in hetzelfde CLI-profiel dat de claim creëerde. De eigenaar voltooit aanmelding, e-mail verificatie en toestemming in de browser; de CLI ontvangt de credential.

Voltooien en verifiëren
flashdata auth finish --wait --timeout 10m
flashdata auth status --json

402: onvoldoende kredieten

Vergelijk availableCredits met de huidige prijs voor uw bron. Claim een uitgeput proefwerk om de saldo van de eigenaar te gebruiken, of laat de eigenaar Billing beoordelen voordat opnieuw te proberen.

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

Gratis account leest
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: wacht alvorens opnieuw te proberen

Lees Retry-After over het falende antwoord: seconden of een HTTP-datum. Wacht tot dan en verminder concurrency. Trial registratie maakt het mogelijk drie registraties per IP per 24-uur venster; hergebruik het oorspronkelijke profiel en registratie bewijs.

Deze gratis gelezen toont het opslaan van headers, status en lichaam. Gebruik de Retry-After van de operatie die is mislukt; query, registratie en account-read limieten kunnen verschillen.

Neem de respons op · 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
)
Inspecteer rekeningcapaciteit
flashdata account limits

400 / 422: afgewezen invoer of verwerking storing

Lees code, detail en fieldErrors van de HTTP fout. Corrigeer het verzoek lichaam, sla het op als request.json en valideer het vervolgens. Bewaar de opslaggegevens van Download in een privé invoerbestand. Als 422 afkomstig is van het resultaat van een bestaande taak, inspecteer job.error eerst.

Valideren zonder betaling
flashdata query --input request.json --mode async --dry-run --json

Afgelopen taak, of HTTP 200 met een mislukte taak

Lees de taak van submission.json, uw opgeslagen async-bon. HTTP 200 betekent dat de status is geslaagd; job.status is het taakresultaat (data.status in CLI JSON). Voor Batch, sla de relevante invoer uit queries als submission.json.

Status of foutVolgende actie
pending / processingWacht op hetzelfde werk; dien het niet opnieuw in.
completedHet bestaande resultaat ophalen en opslaan.
failedInspecteer job.error voordat u gecorrigeerd werk indient.
404Controleer de taak ID en het inzendaccount.
409De resultaten zijn nog niet klaar. Blijf hetzelfde doen.
410Opgeslagen JSON verlopen na 24 uren. Gebruik uw opgeslagen kopie; geleverd media heeft een eigen opslagruimte.
Controleer de opgeslagen taak · 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
)
Nog steeds actief · gebruik de geretourneerde JOB_ID
flashdata jobs wait JOB_ID
Voltooid · gebruik een nieuwe uitvoer bestandsnaam
flashdata jobs result JOB_ID --output recovered-result.json

Timeout / 5xx: werd de taak geaccepteerd?

Controleer de originele run en History voordat u een POST opnieuw probeert. Herstellen van een bevestigde geaccepteerde baan. Als acceptatie onbekend is, houd de ID-run en contactondersteuning; het wijzigen van IDs en het opnieuw inzenden kunnen de kosten dupliceren.

Eerst controleren · RUN_ID vervangen
flashdata runs show RUN_ID
Herstellen van bevestigde geaccepteerde werkzaamheden
flashdata runs recover RUN_ID

CLI output_exists: het resultaatbestand bestaat al

De CLI overschrijft --output-bestanden niet. Lees het bestaande bestand, of kies een nieuwe uitvoer bestandsnaam terwijl de oorspronkelijke --run-id en verzoek. Vind geen nieuwe ID uit om deze fout te omzeilen.

Controleer de oorspronkelijke run
flashdata runs show RUN_ID

Lege zoekopdracht, ontbrekende bijschriften of onleesbare download

Deze commando's lezen alleen lokale resultaatbestanden, niet de CLI's stdout envelop.

MCP-gereedschappen ontbreken of verlopen

Controleer de host die de taak uitvoert. Een opgegeven server bevestigt de configuratie, geen werkende verbinding. Als de geconfigureerde gehoste OAuth-verbinding inloggen vereist, voer dan het inlogcommando uit en vul de browsergoedkeuring in en vernieuw de lijst met gereedschappen.

Open /mcp in de Codex CLI om de verbindingsstatus en -tools te controleren. Controleer in de app de geconfigureerde server en start een nieuwe sessie na wijzigingen van de setup.

Configuratie controleren
codex mcp list
Alleen als u zich aanmeldt bij OAuth
codex mcp login flashdata --scopes mcp:research

Skill geïnstalleerd, maar de agent kan het niet vinden of gebruiken

Controleer hetzelfde project, host profiel en installeer locatie en start vervolgens een nieuwe agent sessie. CLI taakvaardigheden hebben de CLI nodig; flashdata-mcp heeft een aangesloten MCP server nodig. Het installeren van een vaardigheid verbindt geen server of verleent accountmachtigingen.

Controleer de standaard CLI vaardigheidsbundel
flashdata skills verify --agent codex

Veelgestelde vragen

Verbinding maken

Heb ik een Al-agent nodig?

Nee. Gebruik de HTTP API, Go/Python/TypeScript SDK, CLI of console direct. MCP en vaardigheden zijn extra opties voor agenten.

Welke interface moet ik kiezen?

Gebruik een SDK of HTTP API in een app, de CLI voor terminaltaken, en MCP voor een MCP-geschikte host. Vaardigheden bieden instructies voor ofwel CLI taken of verbonden MCP tools; ze vervangen geen authenticatie.

Kan ik referenties hergebruiken voor terugkerende taken?

Ja. Gebruik de eigenaar toegang en behoud hetzelfde beschermde CLI profiel, runtime secret of MCP verbinding. Voor toegang tot API-toets, controleer recurringAllowed: true. Uw gastheer of planner doet het schema.

Herroept het verwijderen van lokale instellingen de toegang?

Nee. Trek de API-sleutel of verbinding in de console in. Het verwijderen van lokale instellingen verwijdert alleen die lokale kopie.

Proeven en kredieten

Kan een agent FlashData proberen voordat u zich aanmeldt?

Ja, met in aanmerking komende tijdelijke toegang via de CLI of aan boord API. Gebruik hetzelfde profiel en registratiebewijs opnieuw. Voortgezette gebruik moet claimen of een bestaande eigenaar API sleutel.

Voegt het claimen nog een processubsidie toe?

Het claimen zelf verleent geen extra studiepunten. Toekomstige verzoeken maken gebruik van de rekeningsaldo van de eigenaar; ongebruikte tijdelijke kredieten niet overmaken. Een nieuw aangemaakte rekening volgt het normale signup-kredietbeleid.

Hoeveel verzoeken kunnen mijn credits dekken?

Controleer rekening evenwicht en bron prijzen. Het aantal verzoeken hangt af van de bron en gemengde brontaken delen één saldo. YouTube Download wordt geprijsd door gedownloade bytes, geen vaste aanvraagtelling.

Bronnen en resultaten

Waarom kan mijn agent zoeken maar niet downloaden?

Download heeft toegang tot de eigenaar, youtube_download toestemming en opslag van de bestemming nodig. Tijdelijke proeven en mcp:research OAuth bevatten geen Download. Een geautoriseerde eigenaar API sleutel kan het gebruiken via CLI, HTTP of MCP.

Geeft Google Search volledige webpagina's terug?

Het geeft zoekresultaten en fragmenten terug. Uw app of agent leest de geselecteerde URLs.

Genereert FlashData videosamenvattingen of bijschriften?

Het haalt metadata en bestaande bijschriften op. Het genereert geen ontbrekende bijschriften; uw model schrijft een samenvatting van de beschikbare resultaten.

Nog steeds vast? Een minimaal rapport versturen

Sla de HTTP foutlichaam of CLI JSON fout uit stderr als diagnostic.json. Alleen identificaties uitpakken na een mislukt commando. Hou sleutels, privé-query tekst en ondertekend URLs uit het rapport. Voor niet-JSON-antwoorden, rapporteer de HTTP-status van diagnostic-status.txt.

Neem een gratis CLI toegangscontrole · Bash
flashdata auth status --json 2> diagnostic.json
Fout-identificaties voor uitpakken · 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
Verslag over de ondersteuning
UTC-tijd:
Client + versie:
Bron + stadium (auth / submit / poll / fetch):
HTTP status + foutcode:
Vraag ID / job ID / run ID:
Inzendingsresultaat: aanvaard / afgewezen / onbekend
Verwacht vs het werkelijke resultaat: