Documentatie bekijken
Aan de slag
Maak een sleutel voor uw app of agent. Bewaar het, controleer toegang en beheer van de levenscyclus.
Op deze pagina
1. Een sleutel aanmaken
- Meld je aan bij je geverifieerde account en open API Keys. Hergebruik een geautoriseerde sleutel als je er al een hebt.
- Noem het voor de app en omgeving, selecteer een vervaldatum en kies de bronnen die het nodig heeft. Selecteer Google Search voor het eerste zoekvoorbeeld.
- Maak de sleutel aan en sla hem hieronder op. Geef onafhankelijke agenten en productie-apps aparte sleutels zodat u ze individueel kunt intrekken.
2. Sleutel opslaan
Kies de manier waarop u FlashData draait. API en SDK voorbeelden lezen FLASHDATA_API_KEY; de CLI kan de sleutel opslaan in het beschermde profiel. In productie, injecteer je referenties uit je geheime winkel.
# 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# 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 flashdataSecureKeyPlak de sleutel op de verborgen prompt. Voor een genoemd profiel, voeg --profile NAAM hier en in latere commando's toe. Voor een eerder geconfigureerd profiel is een login --replace nodig om de sleutel te vervangen.
flashdata auth login3. Toegang verifiëren
Voer de vrije controle uit in dezelfde terminal of CLI profiel. Gebruik het tabblad dat overeenkomt met hoe u de sleutel hebt opgeslagen.
Hergebruik FLASHDATA_API_KEY van de eerdere controle in dezelfde terminal.
(
: "${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'
)Hergebruik FLASHDATA_API_KEY van de eerdere controle in dezelfde terminal.
& {
$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 uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.
flashdata auth statusBevestig de account en bron
HTTP geeft deze velden direct terug. Met CLI JSON, vind ze onder data.identity.identity en heb ook data.accessVerified: true nodig.
| Controleren | Verwacht |
|---|---|
| accountId | De rekening die eigenaar is van deze werklast. |
| access | ready |
| scopes | Inclusief google_search voor de eerste zoekopdracht. |
| recurringAllowed | true voor de geplande eigenaar werken. |
Hoe bronrechten werken
Een sleutel kan alleen de toegekende bronnen gebruiken. De productselectie is gescheiden van de prijs: elke sleutel op de rekening geeft uit van het gedeelde saldo, inclusief gekochte credits. Een beperkte sleutel heeft geen eigen uitgavenplafond. Voor toekomstige producten is een uitdrukkelijke toestemmingssubsidie nodig.
Als een sleutel wordt blootgesteld
- Trek de blootgestelde sleutel onmiddellijk in op de bijpassende console pagina hieronder, en stop de geplande beller.
- Maak een vervanging met de benodigde permissies, installeer het in de geheime winkel van elke beller, en voer de gratis verificatie hierboven.
- Bekijk History en accountgebruik voor onverwachte activiteit. Het verwijderen van een geheim uit een bestand trekt het niet in.
Een sleutel draaien
- Maak een vervanger aan met de vereiste bronnen en installeer deze in de doelomgeving.
- Herhaal de vrije verificatie hierboven, schakel dan de toepassing of scheduler. Elke beoogde beller bijwerken.
- Trek de oude sleutel in nadat de beller is overgestapt. Een geheim bijgewerkt op uw laptop werkt niet bij geïmplementeerde diensten.
flashdata auth login --replace
flashdata auth statusToegang ongedaan maken
Stop geplande beller, trek de bijbehorende sleutel of verbinding hieronder, herhaal dan de gratis verificatie met de oude credentiaal. Het moet worden afgewezen. Lokaal uitloggen trekt de toegang tot de server niet in.
| Toegangstype | Waar moet ik intrekken |
|---|---|
| Gewone API-sleutel | API Keys |
| Sleutel van de opgeëiste agent | Settings → Connected apps → Agent connections |
| MCP OAuth-subsidie | Settings → Connected apps |