Przeglądaj dokumentację
Pierwsze kroki
Sprawdzić pojemność konta, odpowiedzieć na limity stawek i ukończone prace toru.
Na tej stronie
Sprawdź swoje limity
Limity są zgodne z Twoim kontem i planem. Uruchom ten bezpłatny czek z kluczem, który przekaże pracę; wszystkie klucze na koncie mają taką samą pojemność.
Użyj zapisanego dostępu do CLI. Dla o nazwie profilu, przyłącz nazwę --profile do każdego polecenia. Te odczyty nie wydają kredytów zapytania.
flashdata account limitsWymaga Bash i cURL 7.76 +. Pomiń ukryty sygnał, jeśli Twoje środowisko już dostarcza FLASHDATA_API_KEY. Uruchom polecenia odczytu w tym samym terminalu.
# 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'
)Pomiń ukryty sygnał klawisza, jeśli FLASHDATA_API_KEY jest już ustawiony. Uruchom polecenia odczytu w tym samym terminalu.
# 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
}Zrozumienie każdej granicy
Zacznij od jednego wniosku o wlot, a następnie zwiększyć w ramach zgłoszonych limitów. HTTP odczytywane punkty końcowe i rejestracja prób również mają swoje własne limity stawek; te pola zdolności nie są kwotami requests- per- minute.
| Pole | Znaczenie |
|---|---|
| limits.concurrency | Zaplanuj pułap dla jednoczesnej pracy, a nie liczenie wolnych szczelin. |
| limits.batchSize | Maksymalne pozycje w jednej partii. |
| limits.pendingJobs | Maksymalna liczba oczekujących miejsc pracy na koncie. |
| current.pendingJobs | W oczekiwaniu na liczenie w czasie odczytu. Może się zmienić przed poddaniem. |
Utrzymać odpowiedź 429
Odczytaj trud i nagłówek Retry-After. Aby sprawdzić czytane konto, uruchom go w terminalu Bash, gdzie jest ustawiony FLASHDATA_API_KEY. Nagłówki są zapisywane na limits-headers.txt i odpowiedzi na 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.jsonPoczekaj zanim ponownie spróbujesz
Ten przykład oznacza odczekanie co najmniej 60 sekund. Retry-After może być również datą HTTP. Użyj zwróconej wartości, a nie stałego opóźnienia.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Wybierz następną akcję
| Sytuacja | Działanie |
|---|---|
| Pełna pojemność | Zredukuj współwalutę lub czekaj na oczekujące zadania do finish. |
| Nr Retry-After | Użyj buforowanego backoff z jitter i skończonego limitu ponownego próby. |
| Ograniczona rejestracja | Czekaj, potem spróbuj ponownie z tym samym profilem, wejściem i dowodem. Nie przełączaj IP. |
| Złożenie w wyznaczonym czasie | Przed ponownym uruchomieniem należy sprawdzić istniejący bieg lub zadanie; jego wynik jest nieznany. |
Odczytywanie konta
Domyślne okno to ostatnie siedem dni. Zastosowanie obejmuje wszystkie klucze konta, ograniczone do źródeł, do których ten klucz może mieć dostęp.
Użyj zapisanego dostępu do CLI. Dla o nazwie profilu, przyłącz nazwę --profile do każdego polecenia. Te odczyty nie wydają kredytów zapytania.
flashdata account usagePonowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.
(
: "${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'
)Ponowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.
& {
$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
}Sprawdź ukończone prace i kredyty
Przeczytaj sumy i bySource, a następnie porównaj z i do swoich rekordów zadań. CLI JSON owija odpowiedź w danych. Ostatnie wnioski lub refundacje mogą zająć trochę czasu, aby się pojawić, nawet podczas aktualizacji jest false.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}Filtruj zakres źródła i daty
Zastąp daty UTC okresem sprawozdawczym do dnia 31. Od inclusive i do wyłączności; oba są zaokrąglone do minut. Odczytuje to tylko istniejące wykorzystanie.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"