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

Premiers pas

Limites et consommation

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.

Consultations gratuites du compte
flashdata account limits

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.

ChampSignification
limits.concurrencyPlafond du forfait pour les traitements simultanés, et non nombre de places disponibles.
limits.batchSizeNombre maximal d’éléments dans un envoi batch.
limits.pendingJobsNombre maximal de traitements en attente pour le compte.
current.pendingJobsNombre 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.

Enregistrer le statut, les en-têtes et le corps · Bash / cURL
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.json

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

Exemple d’en-têtes de réponse
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Choisir l’action suivante

SituationAction
Capacité atteinteRéduisez le nombre de traitements simultanés ou attendez que ceux en attente se terminent.
Pas de Retry-AfterAugmentez progressivement le délai entre les tentatives, avec un plafond, une variation aléatoire et un nombre limité de tentatives.
Inscription limitéeAttendez, 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.

Consultations gratuites du compte
flashdata account usage

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.

Extrait de réponse illustratif
{
  "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.

Exemple de période de suivi
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"