Documentatie bekijken
Integraties
Verbind met een API sleutel of MCP OAuth, verifieer toegang zonder betaalde query en hergebruik deze voor latere taken.
Op deze pagina
1. Kies en verbind
Al verbonden? Ga direct naar de gratis controle in stap 2. Kies anders de toegang die uw applicatie of agent nodig heeft.
| Jullie verbinden elkaar | Gebruik | Wie houdt de credential? |
|---|---|---|
| Een app, SDK, CLI of gepland script | Eigenaar API sleutel | De geheime opslag van uw server of het CLI profiel |
| Codex of OpenClaw onderzoekstools | MCP OAuth | De host na browser toestemming |
| Een agent die FlashData probeert zonder account | Tijdelijke API-sleutel | De agent heeft het proefprofiel opgeslagen, en dan de eigenaar toegang na claimen |
Maak een sleutel aan in API Keys met de bronnen die uw taak nodig heeft, of hergebruik een bestaande sleutel. Lever het aan uw SDK of stuur het als X-API-Key van uw backend. De Bash en PowerShell controles in stap 2 werken rechtstreeks met de API; er is geen CLI installatie nodig.
Gebruik een host geconfigureerd voor FlashData OAuth. De eigenaar van de account vult de aanmelding of aanmelding en toestemming in de browser aan; de host slaat de tokens op. Deze verbinding installeert geen CLI sleutel of claimt een proefversie.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchVoor een agent zonder sleutel, discover de huidige proef in aanmerking komen voor registratie. Hergebruik een bestaande proef en het profiel. YouTube Download en terugkerende taken vereisen toegang tot de eigenaar.
flashdata discover --profile research --jsonWelke bronnen kunnen deze credential gebruiken?
Gebruik X-API-Key voor normale HTTP-verzoeken en API-sleutel MCP-verbindingen. OAuth tokens werken alleen op het MCP eindpunt. YouTube Download heeft een eigenaar API sleutel nodig met youtube_download en bestemmingsopslag.
| Credentieel | Beschikbare bronnen |
|---|---|
| Eigenaar API sleutel | De bronnen die aan de sleutel zijn toegekend, inclusief youtube_download wanneer deze is goedgekeurd. |
| Tijdelijke API-sleutel | Alleen in aanmerking komende bronnen. Lees scopes van de huidige identiteitsrespons. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Een sleutel opslaan in de CLI
Skip import als de CLI al toegang heeft of je geheime manager FLASHDATA_API_KEY levert. Kies anders een methode hieronder en houd hetzelfde onderzoeksprofiel voor latere commando's. Een opgeslagen CLI-sleutel is niet automatisch beschikbaar voor SDK's of lokale MCP-servers.
Plak de sleutel op de verborgen terminalprompt.
flashdata auth login --profile researchStel FLASHDATA_KEY_FILE in op het pad van een bestaand beveiligd sleutelbestand. Het commando leest het via stdin; houd de sleutel buiten de chat- en commandoargumenten.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"2. Verifiëren van de verbinding
Voer de gratis controle in de omgeving die de taak zal uitvoeren. CLI en HTTP controles gebruiken een API sleutel; de MCP controle gebruikt de eigen opgeslagen verbinding van de host.
Vereist Bash en cURL 7.76+. Sla de verborgen sleutelprompt over als uw omgeving al FLASHDATA_API_KEY levert. Voer de leesopdrachten uit in dezelfde terminal.
# 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(
: "${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'
)Sla de verborgen sleutelprompt over als FLASHDATA_API_KEY al is ingesteld. Voer de leesopdrachten uit in dezelfde terminal.
# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKey& {
$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
}Gebruik de OS gebruiker, profiel en status directory van login. Onderzoek vervangen als je een ander profiel gebruikt; --state-dir PATH toevoegen indien nodig. FLASHDATA_API_KEY overschrijft de opgeslagen sleutel. Verwacht ok: true en data.accessVerified: true; inspecteer dan de onderstaande identiteitsvelden.
flashdata auth status --profile research --json --non-interactiveStuur dit naar een nieuwe sessie van je verbonden agent. Vervang google_search met de broncode die uw taak nodig heeft. Verwacht dat beide instrumenten succesvol zullen zijn; controleer de prijzen en het saldo afzonderlijk voor betaald werk. Een server alleen op de lijst controleert de toegang niet.
Gebruik de bestaande flashdata MCP-verbinding.
Bel get_pricing met {"source":"google_search","request_count":1}.
Bel get_balance met {}.
Rapporteren of beide oproepen zijn geslaagd, of de bron een beschikbare prijs heeft,
en het beschikbare kredietsaldo. Een nulbalans is geen authenticatiefout.
Voer geen zoekopdracht of download uit, maak een proefversie aan of wijzig de referenties.Lees de API-toets identiteit
HTTP identiteitsvelden bevinden zich op het hoogste niveau. In CLI JSON, lees data.identity.identity en vereist data.accessVerified: true. HTTP 200 of CLI ok: true alleen is niet genoeg.
| Controleren | Vereist resultaat |
|---|---|
| Beoogde rekening | accountId en apiKeyId identificeren de account en sleutel die u wilde gebruiken. |
| Bruikbare toegang | access: ready |
| Taakmachtiging | scopes bevat de bron, zoals google_search. CLI bevat ook de toegestane bronnen in data.identity.permittedSources. |
| Terugkerende taak | accountType: owned · installed: true · recurringAllowed: true |
Een actieve proef is een geldige verbinding
Een proef kan een eenmalige taakcontrole doorstaan terwijl recurringAllowed false is. Lees de werkelijke scopes en het verstrijken; claim de bestaande trial voordat het werk inplannen.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Zoek de verbinding in Codex
Lijst geconfigureerde servers, gebruik dan /mcp in een verse Codex sessie. Voer de MCP controle hierboven om de betrouwbaarheid te verifiëren.
codex mcp listControleer de verbinding in OpenClaw
Probeer de opgeslagen server, voer dan de MCP check hierboven in uw actieve gesprek.
openclaw mcp doctor flashdata --probe3. Toegang hergebruiken voor latere taken
Houd de credential store privé en persistent over proces herstarten. Controleer de toegang opnieuw in een nieuw proces voordat u uw scheduler inschakelt.
| Credentieel | Voor de volgende taak |
|---|---|
| Eigenaar API sleutel | Hergebruik de opgeslagen sleutel. Het heeft geen OAuth-vernieuwstap; vervangen indien verlopen of ingetrokken. |
| MCP OAuth | De host verfrist een uur OAuth toegang tokens met behulp van roterende refresh tokens. Verbinding maken wanneer de 90-dagsubsidie afloopt of wordt ingetrokken. Elke installatie is eigenaar van zijn token store; niet delen van nagelezen bestanden tussen hosts. |
| Tijdelijke API-sleutel | Finish eigenaar claimen en geloofwaardige overdracht voordat terugkerende werk. Hergebruik het oorspronkelijke profiel; niet opnieuw registreren voor elke run. |
Controleer een CLI taak voordat u deze inplannen
Vereist Bash en jq. Stel BRON in op de bron van de taak. Het script maakt standaard gebruik van onderzoek; stel FLASHDATA_PROFILE en FLASHDATA_STATE_DIR in voor een ander profiel of een andere map. Afsluiten 0 met identiteit JSON betekent dat de eigenaar sleutel is klaar, geïnstalleerd en toegestaan voor deze bron. Laat je planner stoppen bij elke andere uitgang. Er wordt geen vraag gesteld.
(
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}'
)Als toegang nog steeds een proef is
Voltooi de proef en claimen gids met het oorspronkelijke profiel. Na de goedkeuring van de eigenaar en de geloofwaardige overdracht, de gratis controle moet tonen eigen toegang en recurringAllowed: true. Voortgezette verzoeken maken gebruik van het gedeelde saldo van de eigenaar; ongebruikte studiepunten worden niet overgedragen. MCP OAuth login is een aparte verbinding en claimt deze proef niet.
Toegang ongedaan maken
Pauzeer terugkerende taken eerst. Herroep de bijbehorende credential hieronder, herhaal dan de vrije controle van een nieuw proces of sessie voordat u lokale toegang opruimt. Verwacht een fout in authenticatie of een reconnect verzoek; keurt geen nieuwe verbinding goed tijdens de controle. Lokale afmelden alleen trekt de toegang tot de server niet in.
| Verbinding | Waar moet ik intrekken |
|---|---|
| MCP OAuth | Settings → Connected apps → de app subsidie. |
| Geclaimde agent API sleutel | Settings → Connected apps → Agent verbindingen. |
| Account API-sleutel | API Keys → de sleutel die door deze integratie wordt gebruikt. |
Foute controle herstellen
| Resultaat | Actie |
|---|---|
| accessVerified: false | Lees fase en nextCommand. Een in behandeling zijnde profiel kan ok: true retourneren voordat een sleutel bruikbaar is. De opgeslagen registratie of claim afronden; hetzelfde profiel behouden. |
| access: blocked | Stop zelfs als de HTTP respons 200 was. Bekijk het account of de verbinding in de console; behandel een identiteitsantwoord niet als toestemming om te vragen. |
| accountType: temporary | Gebruik de proef voor eenmalig werk. Claim het voor het plannen; een nieuwe OAuth-verbinding claimt dit profiel niet. |
| installed: false | Na de goedkeuring van de eigenaar, start flashdata auth finish --wait met de oorspronkelijke profiel- en state directory. Herhaal dan de cheque. |
| 401 / invalid_grant | Verbind de verlopen of herroepen credential in zijn oorspronkelijke host. Begin niet weer een proces om het te omzeilen. |
| 403 / source_forbidden | Controleer de scopes van de sleutel of de OAuth bronlijst. YouTube Download maakt gebruik van een API sleutel. |
| Geldige toegang, nulbalans | Authenticatie werkte. Controleer Billing voor betaald werk; vervang geen geldige sleutel. |