Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Integraties

Agent-authenticatie-opties

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 elkaarGebruikWie houdt de credential?
Een app, SDK, CLI of gepland scriptEigenaar API sleutelDe geheime opslag van uw server of het CLI profiel
Codex of OpenClaw onderzoekstoolsMCP OAuthDe host na browser toestemming
Een agent die FlashData probeert zonder accountTijdelijke API-sleutelDe 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.

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

CredentieelBeschikbare bronnen
Eigenaar API sleutelDe bronnen die aan de sleutel zijn toegekend, inclusief youtube_download wanneer deze is goedgekeurd.
Tijdelijke API-sleutelAlleen in aanmerking komende bronnen. Lees scopes van de huidige identiteitsrespons.
MCP OAuthgoogle_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.

Eenmaal importeren
flashdata auth login --profile research

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.

De sleutel instellen · overslaan indien reeds ingesteld
# 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
Lees 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'
)

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.

ControlerenVereist resultaat
Beoogde rekeningaccountId en apiKeyId identificeren de account en sleutel die u wilde gebruiken.
Bruikbare toegangaccess: ready
Taakmachtigingscopes bevat de bron, zoals google_search. CLI bevat ook de toegestane bronnen in data.identity.permittedSources.
Terugkerende taakaccountType: 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.

Tijdelijke identiteit · illustratieve velden
{
  "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.

Lijst servers
codex mcp list

Controleer de verbinding in OpenClaw

Probeer de opgeslagen server, voer dan de MCP check hierboven in uw actieve gesprek.

De server scannen
openclaw mcp doctor flashdata --probe

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

CredentieelVoor de volgende taak
Eigenaar API sleutelHergebruik de opgeslagen sleutel. Het heeft geen OAuth-vernieuwstap; vervangen indien verlopen of ingetrokken.
MCP OAuthDe 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-sleutelFinish 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.

Vers proces toegangscontrole · 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}'
)

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.

VerbindingWaar moet ik intrekken
MCP OAuthSettings → Connected apps → de app subsidie.
Geclaimde agent API sleutelSettings → Connected apps → Agent verbindingen.
Account API-sleutelAPI Keys → de sleutel die door deze integratie wordt gebruikt.

Foute controle herstellen

ResultaatActie
accessVerified: falseLees 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: blockedStop 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: temporaryGebruik de proef voor eenmalig werk. Claim het voor het plannen; een nieuwe OAuth-verbinding claimt dit profiel niet.
installed: falseNa de goedkeuring van de eigenaar, start flashdata auth finish --wait met de oorspronkelijke profiel- en state directory. Herhaal dan de cheque.
401 / invalid_grantVerbind de verlopen of herroepen credential in zijn oorspronkelijke host. Begin niet weer een proces om het te omzeilen.
403 / source_forbiddenControleer de scopes van de sleutel of de OAuth bronlijst. YouTube Download maakt gebruik van een API sleutel.
Geldige toegang, nulbalansAuthenticatie werkte. Controleer Billing voor betaald werk; vervang geen geldige sleutel.