# Обмеження ставок та використання

Перевірка працездатності облікового запису, реагування на ліміти тарифів та контроль виконання робіт.

Канонічне посилання: https://flashdata.dev/uk/docs/guides/usage-and-limits
Переглянуто: 2026-11-04 від FlashData

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

## Перевірити ліміти

Виконайте реєстрацію та підписку на обліковий запис. Запустіть цю безкоштовну перевірку з ключем, який буде подавати роботу; всі ключі на рахунок, що діляться однаковою ємністю.

### CLI

Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.

#### Безкоштовні читання облікового запису

```bash
flashdata account limits
```

- [Налаштування ключа](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Вимагає Bash і cURL 7.76+. Випробуйте приховану клавішу підказки, якщо ваше оточення вже постачає FLASHDATA_API_KEY. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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

Запустіть приховану клавішу, якщо FLASHDATA_API_KEY вже встановлена. Виконайте дані команди в одному терміналі.

#### Встановити ключ · пропустити, якщо вже налаштовано

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

#### Читання облікового запису 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>

### Підтримувати кожен ліміт

Почніть з одного активного запиту й поступово збільшуйте їхню кількість у межах отриманих лімітів. HTTP endpoint для читання та реєстрація пробного доступу мають окремі обмеження частоти; ці поля місткості не є квотами запитів на хвилину.

| Поле | Зручності |
| --- | --- |
| limits.concurrency | Планувати стелю для одночасної роботи, не кількість вільних слотів. |
| limits.batchSize | Максимальні елементи в одному пакетному подачі. |
| limits.pendingJobs | Максимальні робочі місця для рахунку. |
| current.pendingJobs | Прикінчення підрахунку в часі читання. Перед подачею можна змінити. |

- [Обмеження на реєстрацію](https://flashdata.dev/uk/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Відповідність 429

Читати корпус помилки та заголовок Retry-After Для перегляду вільного облікового запису, запустіть це в терміналі Bash, де встановлюється FLASHDATA_API_KEY. Заголовки написані на limits-headers.txt і відповідь на limits.json.

### Статус на сервери 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>

### Очікується до птиху

Цей приклад означає очікування принаймні 60 секунд. Retry-After також може бути дата HTTP. Використовуйте повернуті значення, не зафіксовано затримку.

#### Ілюстраційні головки відповіді

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


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

### Виберіть наступну дію

| Ситуація | Дія |
| --- | --- |
| Місткість повного | Знижувати конваси або чекати закінчення робочих місць до finish. |
| Ні Retry-After | Використовуйте застібку з джиттером і скінченним обмеженням птиця. |
| Реєстрація обмежена | Очікується, потім птиця з тим же профільом, входом і вистоюванням. Не переключайте IP-адреси. |
| Відхилений термін дії | Ознайомтеся з існуючим запуском або роботою перед переадресацією; його результат невідомий. |

- [Відновити переривання завдання](https://flashdata.dev/uk/docs/guides/agent-recovery/reference.md)

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

## Використання облікового запису

Вікно за замовчуванням - останні сім днів. Використання охоплює всі ключі облікового запису, обмежені джерелами, які можуть отримати доступ до цього ключа.

### CLI

Використовуйте ваш збережений CLI access. Для названого профілю, Додаток --profile NAME до кожного команди. Ці дані не витрачають на запити.

#### Безкоштовні читання облікового запису

```bash
flashdata account usage
```

- [Налаштування ключа](https://flashdata.dev/uk/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Запобігти FLASHDATA_API_KEY з попередньою перевіркою в одному терміналі.

#### Читання облікового запису 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

Запобігти FLASHDATA_API_KEY з попередньою перевіркою в одному терміналі.

#### Читання облікового запису 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>

### Перевірити завершені роботи та кредити

Прочитати загальні та bySource, потім порівняти з та з вашими записами завдань. CLI JSON обгортає відповідь в даних. Недавні запити або повернення коштів можуть зайняти час, щоб з'явитися навіть при оновленні false.

#### Ілюстративна відповідь

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

- [Огляд роботи в History](https://flashdata.dev/app/jobs)
- [Витримує заряди](https://flashdata.dev/uk/docs/guides/credits-and-billing/reference.md)

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

### Фільтрувати джерело і діапазон дати

Замініть дати UTC з вашим звітним періодом, до 31 днів. з інклюзивно і до ексклюзивних; обидва закруглені до хвилини. Це тільки наявне використання.

#### Приклад вікна звітності

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

