Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Limiti di tasso e utilizzo

Ispezionare la capacità del conto, rispondere ai limiti di tasso e monitorare il lavoro completato.

In questa pagina

Controlla i tuoi limiti

I limiti seguono il tuo account e il tuo piano. Eseguire questo controllo gratuito con la chiave che invierà il lavoro; tutte le chiavi sul conto condividono la stessa capacità.

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

Leggi di account gratuito
flashdata account limits

Capire ogni limite

Iniziare con una richiesta in volo, quindi aumentare entro limiti segnalati. HTTP ha anche i limiti di velocità e la registrazione di prova; questi campi di capacità non sono quote di richiesta per minuto.

Campo di applicazioneSignificato
limits.concurrencyPiano soffitto per il lavoro simultaneo, non un conteggio di slot gratuite.
limits.batchSizeElementi massimi in un'invio di lotti.
limits.pendingJobsLavori in sospeso per il conto.
current.pendingJobsContare i finanziamenti al momento della lettura. Può cambiare prima della presentazione.

Gestire una risposta 429

Leggi il corpo di errore e l'intestazione Retry-After. Per ispezionare un account gratuito leggere, eseguire questo in un terminale Bash in cui è impostato FLASHDATA_API_KEY. Le intestazioni sono scritte a limits-headers.txt e la risposta a limits.json.

Stato di cattura, intestazioni e corpo · 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

Attendere prima di riprovare

Questo esempio significa aspettare almeno i secondi 60. Retry-After può anche essere una data HTTP. Utilizzare il valore restituito, non un ritardo fisso.

Intestazioni di risposta illustrativa
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Scegli la prossima azione

SituazioneAzione
Capacità pienaRidurre la convalutazione o attendere i lavori in sospeso a finish.
No Retry-AfterUtilizzare il backoff incassato con jitter e un limite di riprovazione finito.
Registrazione limitataAttendere, poi riprovare con lo stesso profilo, input e prova. Non commutare gli IP.
La sottomissione si esaurisceIspezionare la corsa o il lavoro esistente prima di risottomettere; il suo risultato è sconosciuto.

Leggi l'utilizzo dell'account

La finestra di default è gli ultimi sette giorni. L'utilizzo copre tutte le chiavi dell'account, limitate alle fonti che questa chiave può accedere.

Utilizzare l'accesso CLI salvato. Per un profilo chiamato, append --profile NAME a ogni comando. Queste letture non spendono crediti di query.

Leggi di account gratuito
flashdata account usage

Controllare i lavori e i crediti completati

Leggi i totali e bySource, quindi confronta da e verso con i tuoi record di attività. CLI JSON avvolge la risposta nei dati. Le richieste recenti o i rimborsi possono richiedere il tempo di apparire, anche quando l'aggiornamento è false.

Estratto di risposta illustrativa
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

Filtra un intervallo di sorgenti e date

Sostituire le date UTC con il periodo di segnalazione, fino a giorni 31. da è inclusivo e ad è esclusivo; entrambi sono arrotondati fino a minuti. Questo legge solo l'utilizzo esistente.

Esempio finestra di reportistica
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"