Parcourir la documentation
Intégrations
Connectez-vous avec une clé API ou OAuth MCP, vérifiez l’accès sans requête payante et réutilisez-le pour les tâches suivantes.
Sur cette page
1. Choisir et configurer la connexion
Déjà connecté ? Passez directement à la vérification gratuite de l’étape 2. Sinon, choisissez l’accès adapté à votre application ou à votre agent.
| Vous connectez | Méthode | Qui conserve les identifiants ? |
|---|---|---|
| Une application, un SDK, une CLI ou un script planifié | Clé API propriétaire | Le gestionnaire de secrets de votre serveur ou le profil CLI |
| Les outils de recherche de Codex ou d’OpenClaw | MCP OAuth | L’hôte, après autorisation dans le navigateur |
| Un agent qui essaie FlashData sans compte | Clé API temporaire | Le profil d’essai enregistré de l’agent, puis l’accès propriétaire après rattachement |
Créez une clé dans API Keys avec les sources nécessaires à votre tâche, ou réutilisez une clé existante. Fournissez-la au SDK ou envoyez-la dans X-API-Key depuis votre serveur. Les vérifications Bash et PowerShell de l’étape 2 utilisent directement l’API ; aucune installation de la CLI n’est nécessaire.
Utilisez un hôte configuré pour OAuth FlashData. Le propriétaire du compte s’inscrit ou se connecte et autorise l’accès dans le navigateur ; l’hôte enregistre les jetons. Cette connexion n’installe pas de clé CLI et ne rattache pas d’essai.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchPour un agent sans clé, consultez les conditions d’éligibilité actuelles avant l’inscription. Réutilisez un essai existant et son profil. YouTube Download et les tâches récurrentes nécessitent un accès propriétaire.
flashdata discover --profile research --jsonQuelles sources cet accès autorise-t-il ?
Utilisez X-API-Key pour les requêtes HTTP ordinaires et les connexions MCP par clé API. Les jetons Bearer OAuth fonctionnent uniquement sur le point de terminaison MCP hébergé. YouTube Download nécessite une clé API propriétaire autorisant youtube_download et un stockage de destination.
| Identifiant | Sources disponibles |
|---|---|
| Clé API propriétaire | Les sources autorisées pour la clé, y compris youtube_download si cette permission a été accordée. |
| Clé API temporaire | Uniquement les sources autorisées et éligibles à l’essai. Lisez scopes dans la réponse d’identité actuelle. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |
Enregistrer une clé dans la CLI
Ignorez l’importation si la CLI dispose déjà d’un accès ou si votre gestionnaire de secrets fournit FLASHDATA_API_KEY. Sinon, choisissez une méthode ci-dessous et conservez le même profil research pour les commandes suivantes. Une clé enregistrée dans la CLI n’est pas automatiquement disponible dans les SDK ou les serveurs MCP locaux.
Collez la clé dans la saisie masquée du terminal.
flashdata auth login --profile researchDéfinissez FLASHDATA_KEY_FILE avec le chemin d’un fichier de clé protégé existant. La commande le lit via stdin ; ne placez pas la clé dans la conversation ni dans les arguments de commande.
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
< "$FLASHDATA_KEY_FILE"2. Vérifier la connexion
Exécutez la vérification gratuite dans l’environnement qui effectuera la tâche. Les vérifications CLI et HTTP utilisent une clé API ; la vérification MCP utilise la connexion enregistrée par l’hôte.
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.
# 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(
: "${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'
)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.
# 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& {
$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
}Utilisez le même utilisateur du système, le même profil et le même répertoire d’état que lors de la connexion. Remplacez research si vous utilisez un autre profil ; ajoutez --state-dir PATH si nécessaire. FLASHDATA_API_KEY est prioritaire sur la clé enregistrée. Vérifiez ok: true et data.accessVerified: true, puis les champs d’identité ci-dessous.
flashdata auth status --profile research --json --non-interactiveEnvoyez cette consigne dans une nouvelle session de votre agent connecté. Remplacez google_search par la source nécessaire à la tâche. Les deux appels d’outils doivent réussir ; vérifiez les tarifs et le solde séparément avant tout traitement payant. La simple présence d’un serveur dans la liste ne vérifie pas l’accès.
Utilise la connexion MCP flashdata existante.
Appelle get_pricing avec {"source":"google_search","request_count":1}.
Appelle get_balance avec {}.
Indique si les deux appels ont réussi, si un tarif est disponible pour la source
et quel est le solde de crédits disponible. Un solde nul n’est pas un échec d’authentification.
Ne lance aucune recherche ni aucun téléchargement, ne crée pas d’essai et ne modifie pas les identifiants.Lire l’identité associée à la clé API
Dans la réponse HTTP, les champs d’identité se trouvent au premier niveau. Dans le JSON de la CLI, lisez data.identity.identity et vérifiez data.accessVerified: true. HTTP 200 ou ok: true dans la CLI ne suffit pas.
| Point à vérifier | Résultat requis |
|---|---|
| Compte prévu | accountId et apiKeyId identifient le compte et la clé que vous souhaitez utiliser. |
| Accès utilisable | access: ready |
| Autorisation pour la tâche | scopes contient la source, par exemple google_search. La CLI indique aussi les sources autorisées dans data.identity.permittedSources. |
| Tâche récurrente | accountType: owned · installed: true · recurringAllowed: true |
Un essai actif constitue une connexion valide
Un essai peut réussir la vérification d’une tâche ponctuelle alors que recurringAllowed vaut false. Consultez les sources autorisées et l’expiration réelles ; rattachez l’essai existant avant de planifier des tâches.
{
"accountType": "temporary",
"access": "ready",
"installed": false,
"recurringAllowed": false,
"scopes": [
"google_search"
]
}Retrouver la connexion dans Codex
Listez les serveurs configurés, puis utilisez /mcp dans une nouvelle session Codex. Exécutez la vérification MCP ci-dessus pour confirmer la validité des identifiants.
codex mcp listVérifier la connexion dans OpenClaw
Testez le serveur enregistré, puis effectuez la vérification MCP ci-dessus dans votre conversation active.
openclaw mcp doctor flashdata --probe3. Réutiliser l’accès pour les prochaines tâches
Conservez les identifiants dans un stockage privé et persistant entre les redémarrages de processus. Vérifiez l’accès dans un nouveau processus avant d’activer votre planificateur.
| Identifiant | Pour la tâche suivante |
|---|---|
| Clé API propriétaire | Réutilisez la clé enregistrée. Elle n’a pas d’étape de renouvellement OAuth ; remplacez-la si elle expire ou est révoquée. |
| MCP OAuth | L’hôte renouvelle les jetons d’accès OAuth valables une heure à l’aide de jetons de renouvellement rotatifs. Reconnectez-vous lorsque l’autorisation de 90 jours expire ou est révoquée. Chaque installation possède son propre stockage de jetons ; ne partagez pas les fichiers de jetons de renouvellement entre hôtes. |
| Clé API temporaire | Terminez le rattachement au propriétaire et la transmission des identifiants avant les tâches récurrentes. Réutilisez le profil d’origine ; ne vous inscrivez pas à nouveau à chaque exécution. |
Vérifier une tâche CLI avant de la planifier
Nécessite Bash et jq. Définissez SOURCE avec la source utilisée par la tâche. Le script utilise research par défaut ; définissez FLASHDATA_PROFILE et FLASHDATA_STATE_DIR pour choisir un autre profil ou répertoire d’état. Le code de sortie 0, accompagné de l’identité JSON, indique que la clé propriétaire est prête, installée et autorisée pour cette source. Faites arrêter le planificateur pour tout autre code de sortie. Aucune requête de données n’est soumise.
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi
flashdata auth status "${args[@]}" |
jq -e --arg source "$SOURCE" '
select(.ok == true and .data.accessVerified == true)
| .data.identity as $auth
| $auth.identity
| select(.accountType == "owned" and .access == "ready"
and .installed == true and .recurringAllowed == true
and ((.scopes // []) | index($source) != null)
and (($auth.permittedSources // []) | index($source) != null))
| {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)Si l’accès correspond encore à un essai
Suivez le guide d’essai et de rattachement avec le profil d’origine. Après l’approbation du propriétaire et la transmission des identifiants, la vérification gratuite doit indiquer un accès owned et recurringAllowed: true. Les requêtes suivantes utilisent le solde partagé du propriétaire ; les crédits d’essai inutilisés ne sont pas transférés. La connexion OAuth MCP est distincte et ne rattache pas cet essai.
Révoquer l’accès
Suspendez d’abord les tâches récurrentes. Révoquez l’identifiant correspondant ci-dessous, puis répétez la vérification gratuite dans un nouveau processus ou une nouvelle session avant d’effacer l’accès local. L’authentification doit échouer ou demander une reconnexion ; n’approuvez pas de nouvelle connexion pendant cette vérification. Une déconnexion locale ne révoque pas l’accès côté serveur.
| Connexion | Où révoquer l’accès |
|---|---|
| MCP OAuth | Settings → Connected apps → l’autorisation de l’application. |
| Clé API d’un agent rattaché au compte | Settings → Connected apps → Agent connections. |
| Clé API du compte | API Keys → la clé utilisée par cette intégration. |
Corriger une vérification échouée
| Résultat | Action |
|---|---|
| accessVerified: false | Lisez phase et nextCommand. Un profil en attente peut renvoyer ok: true avant que sa clé soit utilisable. Terminez l’inscription ou le rattachement enregistré en conservant le même profil. |
| access: blocked | Arrêtez même si la réponse HTTP est 200. Examinez le compte ou la connexion dans la console ; une réponse d’identité ne constitue pas, à elle seule, une autorisation de lancer une requête. |
| accountType: temporary | Utilisez l’essai éligible pour une tâche ponctuelle. Rattachez-le avant de planifier des tâches ; une nouvelle connexion OAuth ne rattache pas ce profil. |
| installed: false | Après l’approbation du propriétaire, exécutez flashdata auth finish --wait avec le profil et le répertoire d’état d’origine. Répétez ensuite la vérification. |
| 401 / invalid_grant | Reconnectez l’identifiant expiré ou révoqué dans son hôte d’origine. Ne créez pas un autre essai pour contourner cette situation. |
| 403 / source_forbidden | Vérifiez scopes pour la clé ou la liste des sources OAuth. YouTube Download utilise une clé API propriétaire. |
| Accès valide, solde nul | L’authentification a réussi. Consultez la facturation avant tout traitement payant ; ne remplacez pas une clé valide. |