Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Gestione delle chiavi API

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

  1. Accedi al tuo account verificato e apri API Keys. Riutilizzare una chiave autorizzata se ne hai già una.
  2. 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.
  3. 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.

Impostare la chiave per questo terminale
# 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

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

Leggi l'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'
)

Confermare l'account e la fonte

HTTP restituisce questi campi direttamente. Con CLI JSON, trovarli sotto data.identity.identity e richiedono anche data.accessVerified: true.

CheckAttesi
accountIdL'account che possiede questo carico di lavoro.
accessready
scopesInclude google_search per la prima ricerca.
recurringAllowedtrue 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

  1. Rivolgere immediatamente la chiave esposta nella pagina della console corrispondente qui sotto, e fermare i suoi chiamanti programmati.
  2. Creare un sostituto con le autorizzazioni necessarie, installarlo nel negozio segreto di ogni chiamante, ed eseguire la verifica gratuita sopra.
  3. Recensione History e l'utilizzo dell'account per attività inaspettate. La rimozione di un segreto da un file non lo revoca.

Ruotare una chiave

  1. Creare una sostituzione con le fonti richieste e installarlo nell'ambiente di destinazione.
  2. Ripetere la verifica gratuita sopra, quindi passare l'applicazione o programmatore. Aggiorna ogni chiamante previsto.
  3. Rivolgere la vecchia chiave dopo che i chiamanti sono stati scambiati. Un segreto aggiornato sul tuo computer portatile non aggiorna i servizi dispiegati.
Sostituire una chiave CLI · incollare nel prompt nascosto
flashdata auth login --replace
flashdata auth status

Accesso 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 accessoDove revocare
Chiave ordinaria APIAPI Keys
Chiave dell'agente presuntoSettings → Connected apps → Agent connections
Concessione MCP OAuthSettings → Connected apps