Ga naar de inhoud
NL
API-sleutel ophalen
Documentatie bekijken

Aan de slag

Snelheidslimieten en gebruik

Inspecteer de capaciteit van de rekening, reageer op snelheidsgrenzen en track voltooid werk.

Op deze pagina

Controleer uw limieten

Grenzen volgen uw account en plan. Voer deze gratis controle met de sleutel die het werk zal indienen; alle sleutels op de rekening delen dezelfde capaciteit.

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

Gratis account leest
flashdata account limits

Begrijp elke limiet

Begin met één vluchtaanvraag en verhoog dan binnen de aangegeven grenzen. HTTP lees eindpunten en trialregistratie hebben ook hun eigen tarieflimieten; deze capaciteitsvelden zijn geen aanvragen-per-minute quota.

VeldBetekenis
limits.concurrencyPlan plafond voor gelijktijdige werkzaamheden, geen telling van gratis slots.
limits.batchSizeMaximaal aantal stuks in één partij.
limits.pendingJobsMaximale hangende banen voor de rekening.
current.pendingJobsIn afwachting van het tellen op het moment van de lezing. Het kan veranderen voordat het wordt ingediend.

Een 429-respons hanteren

Lees de fouttekst en Retry-After-header. Om een gratis gelezen account te inspecteren, voer dit uit in een Bash terminal waar FLASHDATA_API_KEY is ingesteld. Headers zijn geschreven naar limits-headers.txt en de respons op limits.json.

Status, headers en body vastleggen · 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

Wacht voor het opnieuw proberen

Dit voorbeeld betekent dat je minstens 60 seconden moet wachten. Retry-After kan ook een HTTP datum zijn. Gebruik de geretourneerde waarde, geen vaste vertraging.

Illustratieve responskoppen
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Kies de volgende actie

SituatieActie
Capaciteit volledigVerminder concurrency of wacht op lopende jobs tot finish.
Geen Retry-AfterGebruik afgetopte backoff met jitter en een eindige retry limiet.
Registratie beperktWacht, probeer het dan opnieuw met hetzelfde profiel, invoer en bewijs. Niet van IP wisselen.
Indiening is verlopenInspecteer de bestaande run of taak voordat opnieuw in te dienen; het resultaat is onbekend.

Gebruik van account lezen

Het standaard venster is de laatste zeven dagen. Gebruik omvat alle rekeningsleutels, beperkt tot de bronnen die deze sleutel kan openen.

Gebruik uw opgeslagen CLI toegang. Voor een genoemd profiel, voeg --profile NAAM toe aan elk commando. Deze lezingen besteden geen query kredieten.

Gratis account leest
flashdata account usage

Controleer voltooid werk en credits

Lees totals en bySource en vergelijk from en to met je taakregistratie. CLI JSON plaatst het antwoord onder data. Recente verzoeken of terugbetalingen kunnen later zichtbaar worden, ook als updating false is.

Illustratief antwoord fragment
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

Filter een bron- en datumbereik

Vervang de UTC-data door uw rapportageperiode, tot 31 dagen. van is inclusief en tot is exclusief; beide worden afgerond naar beneden tot minuten. Dit leest alleen bestaand gebruik.

Voorbeeld van rapportagevenster
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"