Sfoglia la documentazione
Per iniziare
Crea una chiave per la tua app o agente. Conservalo, controlla l'accesso e gestisci il suo ciclo di vita.
In questa pagina
1. Creare una chiave
- Accedi al tuo account verificato e apri API Keys. Riutilizzare una chiave autorizzata se ne hai già una.
- Chiamalo per l'app e l'ambiente, seleziona una scadenza e scegli le fonti di cui ha bisogno. Selezionare Google Cerca per il primo esempio di ricerca.
- Creare la chiave e salvarla qui sotto. Dare agenti indipendenti e applicazioni di produzione chiavi separate in modo da poterli revocare individualmente.
2. Conservare la chiave
Scegli il modo in cui eseguirai FlashData. Gli esempi API e SDK leggono FLASHDATA_API_KEY; CLI può salvare la chiave nel suo profilo protetto. In produzione, inietta le credenziali dal tuo negozio segreto.
# 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 flashdataSecureKeyIncollare la chiave al prompt nascosto. Per un profilo chiamato, append --profile NAME qui e nei comandi successivi. Un profilo configurato in precedenza richiede il login --replace per sostituire la sua chiave.
flashdata auth login3. Verificare l'accesso
Eseguire il controllo gratuito nello stesso terminale o profilo CLI. Utilizzare la scheda che corrisponde a come hai memorizzato la chiave.
Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.
(
: "${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'
)Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.
& {
$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
}Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.
flashdata auth statusConfermare l'account e la fonte
HTTP restituisce questi campi direttamente. Con CLI JSON, trovarli sotto data.identity.identity e richiedono anche data.accessVerified: true.
| Check | Attesi |
|---|---|
| accountId | L'account che possiede questo carico di lavoro. |
| access | ready |
| scopes | Include google_search per la prima ricerca. |
| recurringAllowed | true prima del lavoro del proprietario programmato. |
Come funzionano i permessi di origine
Una chiave può utilizzare solo le sue fonti concesse. La selezione del prodotto è separata dai prezzi: ogni chiave dell'account passa dal saldo condiviso, inclusi i crediti acquistati. Una chiave ristretta non ha il proprio tappo di spesa. I prodotti futuri richiedono una licenza esplicita.
Se una chiave è esposta
- Rivolgere immediatamente la chiave esposta nella pagina della console corrispondente qui sotto, e fermare i suoi chiamanti programmati.
- Creare un sostituto con le autorizzazioni necessarie, installarlo nel negozio segreto di ogni chiamante, ed eseguire la verifica gratuita sopra.
- Recensione History e l'utilizzo dell'account per attività inaspettate. La rimozione di un segreto da un file non lo revoca.
Ruotare una chiave
- Creare una sostituzione con le fonti richieste e installarlo nell'ambiente di destinazione.
- Ripetere la verifica gratuita sopra, quindi passare l'applicazione o programmatore. Aggiorna ogni chiamante previsto.
- Rivolgere la vecchia chiave dopo che i chiamanti sono stati scambiati. Un segreto aggiornato sul tuo computer portatile non aggiorna i servizi dispiegati.
flashdata auth login --replace
flashdata auth statusAccesso di fatturazione
Smettere chiamate programmate, revocare la chiave di corrispondenza o la connessione di seguito, quindi ripetere la verifica gratuita con le vecchie credenziali. Dovrebbe essere respinta. L'accesso in loco non revoca l'accesso al server.
| Tipo di accesso | Dove revocare |
|---|---|
| Chiave ordinaria API | API Keys |
| Chiave dell'agente presunto | Settings → Connected apps → Agent connections |
| Concessione MCP OAuth | Settings → Connected apps |