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

Référence canonique : https://flashdata.dev/fr/docs/guides/api-keys-and-permissions
Vérifié le 2026-11-04 par FlashData

<a id="create"></a>

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

- [Ouvrir les clés API](https://flashdata.dev/app/api-keys)
- [Essayer avant de s’inscrire](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

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

### Bash · API / SDK

#### Définir la clé pour ce terminal

```bash
# 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 · API / SDK

#### Définir la clé pour ce terminal

```powershell
# 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 flashdataSecureKey
```


### CLI

Collez la clé dans la saisie masquée. Pour un profil nommé, ajoutez --profile NAME ici et aux commandes suivantes. Pour remplacer la clé d’un profil déjà configuré, utilisez login --replace.

#### Enregistrer la clé

```bash
flashdata auth login
```

- [Installer la CLI](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

## 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é.

### Bash / cURL

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

```bash
(
: "${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'
)
```


### PowerShell 7

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

```powershell
& {
  $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
}
```


### CLI

Réutilisez l’accès enregistré dans la CLI. Pour un profil nommé, ajoutez --profile NAME à chaque commande. Ces lectures ne consomment pas de crédits de requête.

#### Consultations gratuites du compte

```bash
flashdata auth status
```

- [Configurer une clé](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

### 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érifier | Valeur attendue |
| --- | --- |
| accountId | Le compte auquel ce traitement est rattaché. |
| access | ready |
| scopes | Contient google_search pour la première recherche. |
| recurringAllowed | true avant de planifier des tâches avec le compte propriétaire. |

- [Lancer votre première requête](https://flashdata.dev/fr/docs/guides/http-quickstart/reference.md)
- [Vérifier le solde et les tarifs](https://flashdata.dev/fr/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

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

- [Catalogue des autorisations d’agent](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

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

- [Clés API](https://flashdata.dev/app/api-keys)
- [Consommation du compte](https://flashdata.dev/fr/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

## 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

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

## 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ès | Où révoquer l’accès |
| --- | --- |
| Clé API ordinaire | API Keys |
| Clé d’un agent rattaché au compte | Settings → Connected apps → Agent connections |
| Autorisation OAuth MCP | Settings → Connected apps |

- [Clés API](https://flashdata.dev/app/api-keys)
- [Applications connectées](https://flashdata.dev/app/settings/connections)
- [Dépannage de l’authentification](https://flashdata.dev/fr/docs/guides/headers-and-authentication/reference.md#errors)
