# En-têtes et authentification

Choisissez l’adresse et les identifiants adaptés, puis vérifiez l’accès avec une requête gratuite.

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

<a id="requests"></a>

## URL de base

| Usage | URL de base | Authentification |
| --- | --- | --- |
| Requêtes de données et traitements | https://data.flashdata.dev/v1 | X-API-Key |
| Identité, solde, tarifs, limites et consommation | https://api.flashdata.dev/v2 | X-API-Key |
| MCP distant | https://data.flashdata.dev/mcp | OAuth géré par l’hôte ou X-API-Key |


<a id="choose"></a>

## En-têtes d’authentification

Les requêtes REST utilisent X-API-Key avec une clé d’essai ou une clé propriétaire. Envoyez les corps JSON avec Content-Type: application/json. Les profils CLI, les environnements SDK et les connexions MCP stockent leurs identifiants séparément.

### REST / clé API

#### En-têtes de requête

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

Laissez l’hôte MCP obtenir, stocker et renouveler ce jeton lors de la connexion. Utilisez-le uniquement sur le point de terminaison MCP. Les hôtes configurés avec une clé API envoient X-API-Key à la place.

#### En-tête géré par l’hôte MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Obtenir une clé API](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md)
- [Se connecter via MCP](https://flashdata.dev/fr/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## Vérifier votre clé

Exécutez cet exemple dans votre terminal. Le point de terminaison d’identité vérifie l’accès sans consommer de crédits. Ignorez la saisie de la clé si FLASHDATA_API_KEY est déjà définie.

### Bash / cURL

Nécessite Bash et cURL 7.76+. Ignorez la saisie masquée si votre environnement fournit déjà FLASHDATA_API_KEY. Exécutez les commandes de lecture dans le même terminal.

#### Définir la clé · ignorer si elle est déjà configurée

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

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

Ignorez la saisie masquée si FLASHDATA_API_KEY est déjà définie. Exécutez les commandes de lecture dans le même terminal.

#### Définir la clé · ignorer si elle est déjà configurée

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

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



<a id="result"></a>

### Réponse attendue

La réponse doit être HTTP 200. Vérifiez le compte prévu, access: ready et la présence de votre source dans scopes. Une clé temporaire indique accountType: temporary ; les tâches récurrentes du propriétaire nécessitent recurringAllowed: true.

#### Identité du propriétaire · extrait de réponse illustratif

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [Effectuer votre premier appel API](https://flashdata.dev/fr/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## URL de stockage signées

Les URL de résultat et d’envoi de fichiers contiennent leur propre autorisation. Utilisez l’URL renvoyée sans ajouter X-API-Key, de jeton OAuth ni de cookie du navigateur.


<a id="errors"></a>

## Résoudre les erreurs d’authentification

| Réponse | Étape suivante |
| --- | --- |
| 401 | Vérifiez la clé dans cet environnement, sa date d’expiration et son éventuelle révocation. Utilisez une clé API valide, sans jeton MCP ni préfixe Bearer. |
| 403 ou source absente | Demandez au propriétaire d’autoriser la source requise pour cette clé. |
| 503 lors de cette lecture gratuite | Réessayez la lecture plus tard. L’état du compte n’a pas été vérifié ; cela ne confirme pas que vous pouvez lancer une requête payante. |

