# Limity stóp procentowych i zastosowanie

Sprawdzić pojemność konta, odpowiedzieć na limity stawek i ukończone prace toru.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/usage-and-limits
Przegląd: 2026-11-04 przez FlashData

<a id="limits"></a>

## 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ść.

### CLI

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.

#### Bezpłatne czytanie konta

```bash
flashdata account limits
```

- [Ustaw klucz](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Wymaga Bash i cURL 7.76 +. Pomiń ukryty sygnał, jeśli Twoje środowisko już dostarcza FLASHDATA_API_KEY. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

```bash
# 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
```

#### Czytaj konto JSON

```bash
(
: "${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'
)
```


### PowerShell 7

Pomiń ukryty sygnał klawisza, jeśli FLASHDATA_API_KEY jest już ustawiony. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

```powershell
# 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
```

#### Czytaj konto JSON

```powershell
& {
  $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
}
```



<a id="capacity"></a>

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

- [Limity rejestracji próbnej](https://flashdata.dev/pl/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

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

### Status przechwytywania, nagłówki i korpus · Bash / cURL

```bash
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
```


<a id="retry-example"></a>

### Poczekaj 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.

#### Ilustracyjne nagłówki odpowiedzi

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

### Wybierz 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. |

- [Odzyskiwanie przerwanego zadania](https://flashdata.dev/pl/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

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

### CLI

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.

#### Bezpłatne czytanie konta

```bash
flashdata account usage
```

- [Ustaw klucz](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Ponowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.

#### Czytaj konto JSON

```bash
(
: "${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'
)
```


### PowerShell 7

Ponowne użycie FLASHDATA_API_KEY z wcześniejszego sprawdzenia w tym samym terminalu.

#### Czytaj konto JSON

```powershell
& {
  $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
}
```



<a id="usage-result"></a>

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

#### Ilustracyjny fragment odpowiedzi

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [Sprawdź pracę w History](https://flashdata.dev/app/jobs)
- [Zrozumienie opłat](https://flashdata.dev/pl/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

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

#### Przykładowe okno raportowania

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

