Sfoglia la documentazione
Per iniziare
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.
flashdata account limitsRichiede Bash e cURL 7.76+. Salta il prompt dei tasti nascosti se il tuo ambiente già fornisce FLASHDATA_API_KEY. Eseguire i comandi di lettura nello stesso terminale.
# 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'
)Salta il prompt dei tasti nascosti se FLASHDATA_API_KEY è già impostato. Eseguire i comandi di lettura nello stesso terminale.
# 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
}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 applicazione | Significato |
|---|---|
| limits.concurrency | Piano soffitto per il lavoro simultaneo, non un conteggio di slot gratuite. |
| limits.batchSize | Elementi massimi in un'invio di lotti. |
| limits.pendingJobs | Lavori in sospeso per il conto. |
| current.pendingJobs | Contare 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.
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.jsonAttendere 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.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Scegli la prossima azione
| Situazione | Azione |
|---|---|
| Capacità piena | Ridurre la convalutazione o attendere i lavori in sospeso a finish. |
| No Retry-After | Utilizzare il backoff incassato con jitter e un limite di riprovazione finito. |
| Registrazione limitata | Attendere, poi riprovare con lo stesso profilo, input e prova. Non commutare gli IP. |
| La sottomissione si esaurisce | Ispezionare 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.
flashdata account usageRiutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.
(
: "${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'
)Riutilizzare FLASHDATA_API_KEY dal controllo precedente nello stesso terminale.
& {
$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
}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.
{
"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.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"