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

Premiers pas

En-têtes et authentification

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

Sur cette page

URL de base

UsageURL de baseAuthentification
Requêtes de données et traitementshttps://data.flashdata.dev/v1X-API-Key
Identité, solde, tarifs, limites et consommationhttps://api.flashdata.dev/v2X-API-Key
MCP distanthttps://data.flashdata.dev/mcpOAuth géré par l’hôte ou X-API-Key

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.

En-têtes de requête
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

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.

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

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
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

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.

Résoudre les erreurs d’authentification

RéponseÉtape suivante
401Vé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 absenteDemandez au propriétaire d’autoriser la source requise pour cette clé.
503 lors de cette lecture gratuiteRé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.