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

Intégrations

Méthodes d’authentification des agents

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 connectezMéthodeQui conserve les identifiants ?
Une application, un SDK, une CLI ou un script planifiéClé API propriétaireLe gestionnaire de secrets de votre serveur ou le profil CLI
Les outils de recherche de Codex ou d’OpenClawMCP OAuthL’hôte, après autorisation dans le navigateur
Un agent qui essaie FlashData sans compteClé API temporaireLe 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.

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

IdentifiantSources disponibles
Clé API propriétaireLes sources autorisées pour la clé, y compris youtube_download si cette permission a été accordée.
Clé API temporaireUniquement les sources autorisées et éligibles à l’essai. Lisez scopes dans la réponse d’identité actuelle.
MCP OAuthgoogle_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.

Importer une seule fois
flashdata auth login --profile research

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.

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'
)

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érifierRésultat requis
Compte prévuaccountId et apiKeyId identifient le compte et la clé que vous souhaitez utiliser.
Accès utilisableaccess: ready
Autorisation pour la tâchescopes contient la source, par exemple google_search. La CLI indique aussi les sources autorisées dans data.identity.permittedSources.
Tâche récurrenteaccountType: 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.

Identité temporaire · champs illustratifs
{
  "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.

Lister les serveurs
codex mcp list

Vérifier la connexion dans OpenClaw

Testez le serveur enregistré, puis effectuez la vérification MCP ci-dessus dans votre conversation active.

Tester le serveur
openclaw mcp doctor flashdata --probe

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

IdentifiantPour la tâche suivante
Clé API propriétaireRé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 OAuthL’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 temporaireTerminez 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.

Vérifier l’accès dans un nouveau processus · Bash
(
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.

ConnexionOù révoquer l’accès
MCP OAuthSettings → Connected apps → l’autorisation de l’application.
Clé API d’un agent rattaché au compteSettings → Connected apps → Agent connections.
Clé API du compteAPI Keys → la clé utilisée par cette intégration.

Corriger une vérification échouée

RésultatAction
accessVerified: falseLisez 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: blockedArrê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: temporaryUtilisez 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: falseAprè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_grantReconnectez 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_forbiddenVérifiez scopes pour la clé ou la liste des sources OAuth. YouTube Download utilise une clé API propriétaire.
Accès valide, solde nulL’authentification a réussi. Consultez la facturation avant tout traitement payant ; ne remplacez pas une clé valide.