Parcourir la documentation
Premiers pas
Consultez la capacité du compte, gérez les limites de débit et suivez les traitements terminés.
Sur cette page
Consulter vos limites
Les limites dépendent de votre compte et de votre forfait. Exécutez cette vérification gratuite avec la clé qui soumettra les tâches ; toutes les clés du compte partagent la même capacité.
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.
flashdata account limitsNé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/limits' || 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/limits"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Comprendre chaque limite
Commencez par une seule requête en cours, puis augmentez dans les limites indiquées. Les points de terminaison de lecture HTTP et l’inscription aux essais ont aussi leurs propres limites de débit ; ces champs de capacité ne sont pas des quotas de requêtes par minute.
| Champ | Signification |
|---|---|
| limits.concurrency | Plafond du forfait pour les traitements simultanés, et non nombre de places disponibles. |
| limits.batchSize | Nombre maximal d’éléments dans un envoi batch. |
| limits.pendingJobs | Nombre maximal de traitements en attente pour le compte. |
| current.pendingJobs | Nombre de traitements en attente au moment de la lecture. Il peut changer avant l’envoi. |
Gérer une réponse 429
Lisez le corps de l’erreur et l’en-tête Retry-After. Pour examiner une lecture gratuite du compte, exécutez ceci dans un terminal Bash où FLASHDATA_API_KEY est définie. Les en-têtes sont enregistrés dans limits-headers.txt et la réponse dans limits.json.
curl --silent --show-error --max-time 20 \
--header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}" \
--dump-header limits-headers.txt --output limits.json \
--write-out 'HTTP %{http_code}\n' \
https://api.flashdata.dev/v2/api-access/limits
cat limits-headers.txt limits.jsonAttendre avant de réessayer
Cet exemple demande d’attendre au moins 60 secondes. Retry-After peut aussi contenir une date HTTP. Utilisez la valeur renvoyée, pas un délai fixe.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Choisir l’action suivante
| Situation | Action |
|---|---|
| Capacité atteinte | Réduisez le nombre de traitements simultanés ou attendez que ceux en attente se terminent. |
| Pas de Retry-After | Augmentez progressivement le délai entre les tentatives, avec un plafond, une variation aléatoire et un nombre limité de tentatives. |
| Inscription limitée | Attendez, puis réessayez avec le même profil, les mêmes paramètres et la même preuve. Ne changez pas d’adresse IP. |
| Délai d’envoi dépassé | Examinez l’exécution ou le traitement existant avant de soumettre à nouveau la requête ; son résultat est inconnu. |
Consulter la consommation du compte
La période par défaut couvre les sept derniers jours. La consommation inclut toutes les clés du compte, dans la limite des sources accessibles à cette clé.
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.
flashdata account usageRéutilisez FLASHDATA_API_KEY, définie lors de la vérification précédente, dans le même terminal.
(
: "${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/usage' || exit
printf '\n'
)Réutilisez FLASHDATA_API_KEY, définie lors de la vérification précédente, dans le même terminal.
& {
$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/usage"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Vérifier les traitements terminés et les crédits
Lisez totals et bySource, puis comparez from et to à vos enregistrements de tâches. Le JSON de la CLI place la réponse dans data. Les requêtes ou remboursements récents peuvent mettre du temps à apparaître, même lorsque updating vaut false.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}Filtrer par source et par période
Remplacez les dates UTC par votre période de suivi, jusqu’à 31 jours. from est inclus et to est exclu ; tous deux sont arrondis à la minute inférieure. Cette commande consulte uniquement la consommation existante.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"