Aller au contenu
FR
Obtenir une clé API
Parcourir la documentation

Premiers pas

Gestion des clés API

Créez une clé pour votre application ou votre agent. Enregistrez-la, vérifiez l’accès et gérez son cycle de vie.

Sur cette page

1. Créer une clé

  1. Connectez-vous à votre compte vérifié et ouvrez API Keys. Réutilisez une clé autorisée si vous en possédez déjà une.
  2. Donnez-lui un nom correspondant à l’application et à l’environnement, définissez une expiration et choisissez les sources nécessaires. Sélectionnez Google Search pour le premier exemple de recherche.
  3. Créez la clé et enregistrez-la comme indiqué ci-dessous. Attribuez des clés distinctes aux agents indépendants et aux applications en production afin de pouvoir les révoquer séparément.

2. Enregistrer la clé

Choisissez votre mode d’utilisation de FlashData. Les exemples API et SDK lisent FLASHDATA_API_KEY ; la CLI peut enregistrer la clé dans son profil protégé. En production, fournissez les identifiants depuis votre gestionnaire de secrets.

Définir la clé pour ce 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

3. Vérifier l’accès

Exécutez la vérification gratuite dans le même terminal ou profil CLI. Choisissez l’onglet correspondant à la méthode utilisée pour enregistrer la clé.

Réutilisez FLASHDATA_API_KEY, définie lors de la vérification précédente, dans le même terminal.

Lire les données JSON du compte
(
: "${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'
)

Confirmer le compte et la source

HTTP renvoie ces champs directement. Dans le JSON de la CLI, ils se trouvent dans data.identity.identity ; vérifiez également data.accessVerified: true.

Point à vérifierValeur attendue
accountIdLe compte auquel ce traitement est rattaché.
accessready
scopesContient google_search pour la première recherche.
recurringAllowedtrue avant de planifier des tâches avec le compte propriétaire.

Comprendre les autorisations de sources

Une clé ne peut utiliser que les sources qui lui sont autorisées. Le choix des produits est indépendant des tarifs : toutes les clés du compte consomment le solde partagé, y compris les crédits achetés. Une clé restreinte n’a pas de plafond de dépenses individuel. Les futurs produits nécessitent une autorisation explicite.

Si une clé est divulguée

  1. Révoquez immédiatement la clé divulguée dans la page de console correspondante ci-dessous et arrêtez les tâches planifiées qui l’utilisent.
  2. Créez une clé de remplacement avec les autorisations nécessaires, installez-la dans le gestionnaire de secrets de chaque application concernée et effectuez la vérification gratuite ci-dessus.
  3. Consultez l’historique et la consommation du compte pour repérer une activité inattendue. Supprimer un secret d’un fichier ne le révoque pas.

Remplacer une clé

  1. Créez une clé de remplacement autorisant les sources nécessaires et installez-la dans l’environnement cible.
  2. Répétez la vérification gratuite ci-dessus, puis basculez l’application ou le planificateur vers la nouvelle clé. Mettez à jour chaque application concernée.
  3. Révoquez l’ancienne clé une fois la migration terminée. Mettre à jour un secret sur votre ordinateur ne le met pas à jour dans les services déployés.
Remplacer une clé CLI · coller dans la saisie masquée
flashdata auth login --replace
flashdata auth status

Révoquer l’accès

Arrêtez les tâches planifiées, révoquez la clé ou la connexion correspondante ci-dessous, puis répétez la vérification gratuite avec l’ancien identifiant. Il doit être refusé. Une déconnexion locale ne révoque pas l’accès côté serveur.

Type d’accèsOù révoquer l’accès
Clé API ordinaireAPI Keys
Clé d’un agent rattaché au compteSettings → Connected apps → Agent connections
Autorisation OAuth MCPSettings → Connected apps