# FAQ et dépannage

Vérifiez votre accès, corrigez une requête en échec ou trouvez une réponse sur l’utilisation de FlashData.

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

- [Corriger une erreur](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#fix) — Commandes et solutions par symptôme
- [Questions fréquentes](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#faq) — Accès, crédits et données

<a id="diagnose"></a>

## Commencer par une vérification gratuite de l’accès

Lancez la vérification dans l’environnement où la tâche a échoué. Utilisez ses identifiants existants ; ces commandes ne soumettent aucune requête.

### 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 --version
flashdata doctor --offline
flashdata auth status --json
```

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

### Bash / cURL

Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié. Nécessite cURL 7.76+.

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

Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié.

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


- [401 / 403 : identifiants](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#credentials)
- [402 : crédits](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#credits)
- [429 : limite de débit](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#rate-limit)
- [400 / 422 : requête](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#request)
- [Tâche en attente ou en échec](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#jobs)
- [Délai dépassé / 5xx](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#uncertain)
- [Connexion MCP](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#mcp)

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

### Points à vérifier

L’identité doit indiquer access: ready et inclure votre source dans scopes. Dans le JSON de la CLI, elle se trouve sous data.identity.identity ; exigez aussi data.accessVerified: true. Une commande réussie avec accessVerified: false n’a pas vérifié l’accès.

Pour un profil CLI nommé, ajoutez --profile NAME à chaque commande ci-dessous. Conservez le --state-dir et l’utilisateur du système d’origine. FLASHDATA_API_KEY prend le pas sur une clé CLI enregistrée ; les SDK et les hôtes MCP utilisent leur propre configuration d’identifiants.


<a id="fix"></a>

## Identifier et corriger le problème

Ouvrez le symptôme correspondant à votre erreur. Utilisez les identifiants et les reçus de la tâche d’origine.


<a id="runtime"></a>

### Commande introuvable ou profil manquant

Exécutable absent : installez la version adaptée à votre système et à votre processeur, puis ajoutez son dossier à PATH. Profil manquant : utilisez l’utilisateur du système et le répertoire d’état d’origine. Vérifiez aussi l’environnement du planificateur ou du conteneur.

#### Bash

##### Localiser l’exécutable

```bash
command -v flashdata
flashdata --version
flashdata doctor --offline
```


#### PowerShell

##### Localiser l’exécutable

```powershell
Get-Command flashdata
flashdata --version
flashdata doctor --offline
```


- [Installation de la CLI](https://flashdata.dev/fr/docs/guides/flashdata-cli/reference.md#install)
- [Profils et répertoires d’état](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#profiles)

<a id="credentials"></a>

### 401 / 403 : clé, permission ou expiration

Pour remplacer une clé propriétaire enregistrée, collez la clé approuvée dans la saisie masquée. Si FLASHDATA_API_KEY est définie, mettez plutôt ce secret à jour dans l’environnement d’exécution ; enregistrer une autre clé CLI ne la remplacera pas.

1. 401 : vérifiez si la clé est expirée, révoquée ou mal configurée. 403 : comparez la source demandée aux scopes de l’identité.
2. REST et les SDK utilisent X-API-Key. Un jeton OAuth MCP ne remplace pas une clé API. Pour l’accès temporaire, utilisez la procédure de reprise du rattachement ci-dessous.

#### Remplacer et vérifier une clé propriétaire enregistrée

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

- [Permissions et rotation des clés](https://flashdata.dev/fr/docs/guides/api-keys-and-permissions/reference.md#rotate)
- [Reprendre le rattachement](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#claim)
- [Reconnecter MCP](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#mcp)

<a id="claim"></a>

### Rattachement approuvé, mais l’agent utilise encore l’essai

Terminez la transmission dans le profil CLI qui a créé le rattachement. Le propriétaire effectue l’inscription, la vérification de l’adresse e-mail et le consentement dans le navigateur ; la CLI reçoit les identifiants.

#### Déjà approuvé

##### Terminer et vérifier

```bash
flashdata auth finish --wait --timeout 10m
flashdata auth status --json
```


#### Lien expiré

Demandez un nouveau lien pour l’essai existant, laissez le propriétaire approuver, puis lancez auth finish. Ne relancez pas init.

##### Renouveler le lien de rattachement

```bash
flashdata auth claim
```


- [Rattachement et transmission des identifiants](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md#help)
- [Vérifier l’accès propriétaire pour les tâches récurrentes](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md)

<a id="credits"></a>

### 402 : crédits insuffisants

Comparez availableCredits au tarif actuel de votre source. Rattachez un essai épuisé pour utiliser le solde du propriétaire, ou laissez-le consulter Billing avant de réessayer.

#### 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 account balance
flashdata account pricing --source google_search --request-count 1
```

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

#### Bash / cURL

Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié. Nécessite cURL 7.76+.

##### 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/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)
```


#### PowerShell 7

Utilisez la FLASHDATA_API_KEY existante de la tâche dans le même terminal, conteneur ou job planifié.

##### 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/balance"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
  $flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
  Invoke-RestMethod -Uri $flashdataUri `
    -Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
    ConvertTo-Json -Depth 20
}
```


- [Facturation](https://flashdata.dev/app/billing)
- [Essai et rattachement](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)
- [Tarifs des autres sources](https://flashdata.dev/fr/docs/guides/credits-and-billing/reference.md)

<a id="rate-limit"></a>

### 429 : attendre avant de réessayer

Lisez Retry-After dans la réponse en échec : une durée en secondes ou une date HTTP. Attendez jusqu’à cette échéance et réduisez les opérations simultanées. L’inscription à l’essai autorise trois inscriptions par IP sur une fenêtre de 24 heures ; réutilisez le profil et la preuve d’inscription d’origine.

Cette lecture gratuite montre comment enregistrer les en-têtes, le statut et le corps. Utilisez le Retry-After de l’opération qui a échoué ; les limites de requêtes, d’inscription et de lecture du compte peuvent différer.

#### Capturer la réponse · Bash / cURL / jq

```bash
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --dump-header diagnostic-headers.txt --output diagnostic.json \
  --write-out '%{http_code}\n' \
  'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
  $1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
  jq '{access, scopes, status, code, requestId}
    | with_entries(select(.value != null))' diagnostic.json
else
  printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)
```

#### Examiner la capacité du compte

```bash
flashdata account limits
```

- [Limites de débit et délais de reprise](https://flashdata.dev/fr/docs/guides/usage-and-limits/reference.md)

<a id="request"></a>

### 400 / 422 : paramètres rejetés ou échec de traitement

Lisez code, detail et fieldErrors dans l’erreur HTTP. Corrigez le corps de requête, enregistrez-le dans request.json, puis validez-le. Gardez les identifiants de stockage Download dans un fichier d’entrée privé. Si 422 provient du résultat d’une tâche existante, examinez d’abord job.error.

#### Valider sans soumission payante

```bash
flashdata query --input request.json --mode async --dry-run --json
```

- [Références des requêtes par source](https://flashdata.dev/fr/docs/reference/reference.md)
- [Paramètres privés de téléchargement](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md#storage)
- [Examiner une tâche existante](https://flashdata.dev/fr/docs/guides/troubleshooting/reference.md#jobs)

<a id="jobs"></a>

### Tâche en attente, ou HTTP 200 avec une tâche en échec

Lisez la tâche à partir de submission.json, votre reçu asynchrone enregistré. HTTP 200 indique que la lecture d’état a réussi ; job.status indique l’état de la tâche, ou data.status dans le JSON CLI. Pour Batch, enregistrez l’entrée correspondante de queries dans submission.json.

| État ou erreur | Action suivante |
| --- | --- |
| pending / processing | Attendez la même tâche sans la soumettre à nouveau. |
| completed | Récupérez et enregistrez le résultat existant. |
| failed | Examinez job.error avant de soumettre une opération corrigée. |
| 404 | Vérifiez l’identifiant de tâche et le compte utilisé pour la soumission. |
| 409 | Les résultats ne sont pas prêts. Continuez à consulter la même tâche. |
| 410 | Le JSON conservé a expiré après 24 heures. Utilisez votre copie enregistrée ; le média livré suit la conservation de son propre stockage. |

#### CLI

##### Examiner la tâche enregistrée · Bash / jq

```bash
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)
```

##### Encore en cours · utiliser le JOB_ID renvoyé

```bash
flashdata jobs wait JOB_ID
```

##### Terminée · choisir un nouveau nom de fichier de sortie

```bash
flashdata jobs result JOB_ID --output recovered-result.json
```


#### HTTP / cURL

##### Examiner la tâche enregistrée

```bash
# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
  | select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  --header 'Accept: application/json' \
  "$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)
```


- [Lectures d’état et récupération des résultats par HTTP](https://flashdata.dev/fr/docs/guides/async-batch/reference.md)
- [Capacité de tâches en attente](https://flashdata.dev/fr/docs/guides/usage-and-limits/reference.md)

<a id="uncertain"></a>

### Délai dépassé / 5xx : la tâche a-t-elle été acceptée ?

Examinez l’exécution d’origine et History avant de retenter un POST. Reprenez une tâche dont l’acceptation est confirmée. Si l’acceptation est inconnue, conservez l’identifiant d’exécution et contactez le support ; changer d’identifiant et soumettre à nouveau peut doubler la facturation.

#### Examiner d’abord · remplacer RUN_ID

```bash
flashdata runs show RUN_ID
```

#### Reprendre une opération confirmée acceptée

```bash
flashdata runs recover RUN_ID
```

- [Historique des requêtes](https://flashdata.dev/app/jobs)
- [Choisir comment reprendre](https://flashdata.dev/fr/docs/guides/agent-recovery/reference.md)

<a id="output"></a>

### CLI output_exists : le fichier de résultat existe déjà

La CLI n’écrase pas les fichiers --output. Lisez le fichier existant ou choisissez un nouveau nom de sortie en conservant le --run-id et la requête d’origine. N’inventez pas un nouvel identifiant d’exécution pour contourner cette erreur.

#### Examiner l’exécution d’origine

```bash
flashdata runs show RUN_ID
```

- [Fichiers de sortie et reprise des exécutions](https://flashdata.dev/fr/docs/guides/cli-automation/reference.md)

<a id="results"></a>

### Recherche vide, sous-titres absents ou téléchargement illisible

Ces commandes lisent uniquement les fichiers de résultats locaux, pas l’enveloppe stdout de la CLI.

#### Google Search

Si status vaut done et organic est vide, assouplissez les filtres de recherche. Conservez ce résultat vide dans l’enregistrement de la tâche.

##### Examiner les résultats enregistrés · Bash / jq

```bash
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.json
```

- [Filtres de recherche et pagination](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)

#### Sous-titres YouTube

Les métadonnées indiquent les codes de langue, pas si une piste est manuelle ou automatique. Choisissez une langue proposée et définissez explicitement auto : true pour automatique, false pour manuelle. Aucune piste correspondante signifie qu’aucun sous-titre n’est disponible pour cette sélection ; FlashData n’en génère pas de remplacement.

##### Examiner les langues disponibles · Bash / jq

```bash
jq '.results[0].transcriptLanguages' metadata.json
```

- [Choisir une piste de sous-titres](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md#captions)

#### YouTube Download

Lisez le reçu delivery.json terminé. Téléchargez l’objet avec les identifiants de votre stockage de destination, puis comparez sa taille et son MD5 au reçu. Une file_url privée ne devient pas publique après la livraison.

##### Examiner la livraison · Bash / jq

```bash
jq '.results[0] | {file_url, file_size, md5}' delivery.json
```

- [Vérifier la taille et la somme de contrôle](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md#delivery)


<a id="mcp"></a>

### Outils MCP absents ou authentification expirée

Vérifiez l’hôte qui exécute la tâche. Un serveur présent dans la liste confirme sa configuration, mais pas une connexion fonctionnelle. Si la connexion OAuth hébergée demande une authentification, lancez sa commande de connexion, terminez l’approbation dans le navigateur, puis actualisez la liste des outils.

#### Codex

Ouvrez /mcp dans la CLI Codex pour vérifier l’état de la connexion et les outils. Dans l’application, vérifiez le serveur configuré et démarrez une nouvelle session après les changements de configuration.

##### Vérifier la configuration

```bash
codex mcp list
```

##### Uniquement si une connexion OAuth est requise

```bash
codex mcp login flashdata --scopes mcp:research
```

- [Configurer le serveur pour Codex](https://flashdata.dev/fr/docs/integrations/codex/reference.md)

#### OpenClaw

##### Tester le serveur configuré

```bash
openclaw mcp doctor flashdata --probe
```

##### Uniquement si une connexion OAuth est requise

```bash
openclaw mcp login flashdata
openclaw mcp doctor flashdata --probe
```

- [Configurer le serveur pour OpenClaw](https://flashdata.dev/fr/docs/integrations/openclaw/reference.md)

#### Clé API / serveur local

Une connexion OAuth ne répare pas une connexion par clé API. Vérifiez la clé dans l’environnement de l’hôte et ses permissions de sources. Pour stdio en local, vérifiez la version de Node.js requise par le paquet MCP et redémarrez l’hôte après la mise à jour de son environnement.

##### Pour stdio en local

```bash
node --version
```

- [Configurer MCP hébergé avec clé API ou MCP local](https://flashdata.dev/fr/docs/integrations/mcp-clients/reference.md)


<a id="skills"></a>

### Skill installé mais introuvable ou inutilisable par l’agent

Vérifiez le projet, le profil de l’hôte et l’emplacement d’installation, puis démarrez une nouvelle session d’agent. Les skills de tâches CLI nécessitent la CLI ; flashdata-mcp nécessite un serveur MCP connecté. Installer un skill ne connecte pas de serveur et n’accorde pas de permissions sur le compte.

#### Codex · skills CLI

##### Vérifier le lot de skills CLI par défaut

```bash
flashdata skills verify --agent codex
```


#### Codex · skill MCP

##### Vérifier uniquement le skill MCP facultatif

```bash
flashdata skills verify --agent codex --skill flashdata-mcp
```


#### OpenClaw

##### Vérifier la disponibilité des skills

```bash
openclaw skills list --eligible
openclaw skills check
```


- [Installer ou mettre à jour les skills](https://flashdata.dev/fr/docs/guides/agent-skill/reference.md)
- [Connecter MCP](https://flashdata.dev/fr/docs/integrations/mcp-clients/reference.md)

<a id="faq"></a>

## Questions fréquentes


<a id="faq-access"></a>

### Se connecter

| Question | Réponse |
| --- | --- |
| Ai-je besoin d’un agent IA ? | Non. Utilisez directement l’API HTTP, les SDK Go/Python/TypeScript, la CLI ou la console. MCP et les skills offrent des options supplémentaires pour les agents. |
| Quelle interface choisir ? | Utilisez un SDK ou l’API HTTP dans une application, la CLI pour les tâches de terminal et MCP dans un hôte compatible. Les skills fournissent des instructions pour les tâches CLI ou les outils MCP connectés ; ils ne remplacent pas l’authentification. |
| Puis-je réutiliser mes identifiants pour les tâches récurrentes ? | Oui. Utilisez un accès propriétaire et conservez le même profil CLI protégé, secret d’exécution ou connexion MCP. Pour l’accès par clé API, vérifiez recurringAllowed: true. Votre hôte ou votre planificateur gère les horaires. |
| Supprimer les paramètres locaux révoque-t-il l’accès ? | Non. Révoquez la clé API ou la connexion dans la console. Supprimer les paramètres locaux retire uniquement cette copie locale. |

- [Choisir une interface](https://flashdata.dev/fr/docs/reference.md)
- [Configurer une tâche récurrente](https://flashdata.dev/fr/docs/guides/recurring-tasks/reference.md)
- [Agents connectés](https://flashdata.dev/app/settings/connections)

<a id="faq-billing"></a>

### Essais et crédits

| Question | Réponse |
| --- | --- |
| Un agent peut-il essayer FlashData avant l’inscription ? | Oui, avec un accès temporaire éligible via la CLI ou l’API d’intégration des agents. Réutilisez le même profil et la même preuve d’inscription. Pour continuer, rattachez cet accès à un compte ou utilisez une clé API propriétaire existante. |
| Le rattachement accorde-t-il de nouveaux crédits d’essai ? | Le rattachement n’accorde pas de crédits d’essai supplémentaires. Les requêtes suivantes utilisent le solde du compte propriétaire ; les crédits temporaires inutilisés ne sont pas transférés. Un nouveau compte suit la politique normale de crédits à l’inscription. |
| Combien de requêtes mes crédits permettent-ils ? | Consultez le solde du compte et les tarifs des sources. Le nombre de requêtes dépend de la source ; les tâches qui en combinent plusieurs partagent le même solde. YouTube Download est facturé au volume téléchargé en octets, et non selon un nombre fixe de requêtes. |

- [Essai et rattachement](https://flashdata.dev/fr/docs/guides/agent-onboarding/reference.md)
- [Calculer le nombre de requêtes](https://flashdata.dev/fr/docs/guides/credits-and-billing/reference.md)
- [Limites d’inscription et de requêtes](https://flashdata.dev/fr/docs/guides/usage-and-limits/reference.md)

<a id="faq-results"></a>

### Sources et résultats

| Question | Réponse |
| --- | --- |
| Pourquoi mon agent peut-il rechercher, mais pas télécharger ? | Le téléchargement nécessite un accès propriétaire, la permission youtube_download et un stockage de destination. Les essais temporaires et le scope OAuth mcp:research n’incluent pas Download. Une clé API propriétaire autorisée permet de l’utiliser via la CLI, HTTP ou MCP. |
| Google Search renvoie-t-il les pages web complètes ? | Il renvoie des résultats de recherche et des extraits. Votre application ou votre agent lit les URL sélectionnées. |
| FlashData génère-t-il des résumés vidéo ou des sous-titres ? | Il récupère les métadonnées et les sous-titres existants. Il ne génère pas les sous-titres manquants ; votre modèle rédige un résumé à partir des résultats disponibles. |

- [Google Search](https://flashdata.dev/fr/docs/guides/google-search-guide/reference.md)
- [YouTube Data](https://flashdata.dev/fr/docs/guides/youtube-data-guide/reference.md)
- [YouTube Download](https://flashdata.dev/fr/docs/guides/youtube-download-guide/reference.md)

<a id="support"></a>

## Toujours bloqué ? Préparer un rapport minimal

Enregistrez le corps d’erreur HTTP ou l’erreur JSON CLI de stderr dans diagnostic.json. Extrayez les identifiants uniquement après une commande en échec. Excluez du rapport les clés, le texte privé des requêtes et les URL signées. Pour les réponses non JSON, indiquez le statut HTTP de diagnostic-status.txt.

### Capturer une vérification gratuite de l’accès CLI · Bash

```bash
flashdata auth status --json 2> diagnostic.json
```

### Extraire les identifiants d’erreur · Bash / jq

```bash
# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
  status: ($e.httpStatus // $e.status),
  code: $e.code,
  requestId: $e.requestId,
  runId: (.runId // $e.runId),
  jobId: $e.remoteId,
  retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.json
```

### Rapport pour le support

```text
Heure UTC :
Client et version :
Source et étape (auth / submit / poll / fetch) :
Statut HTTP et code d’erreur :
Identifiant de requête / de tâche / d’exécution :
Résultat de soumission : accepted / rejected / unknown
Résultat attendu et résultat constaté :
```

- [Référence des codes d’erreur](https://flashdata.dev/fr/docs/errors/reference.md)
- [Contacter le support](https://flashdata.dev/fr/contact)
