# Ограничения по ставкам и использование

Проверить емкость счета, отреагировать на лимиты ставок и отслеживать выполненную работу.

Каноническая ссылка: https://flashdata.dev/ru/docs/guides/usage-and-limits
Разработчик: 2026-11-04 by FlashData

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

## Проверьте свои пределы

Ограничения следуют за вашим счетом и планом. Запустите эту бесплатную проверку с помощью ключа, который предоставит работу; все ключи на счете имеют одинаковую емкость.

### CLI

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

#### Бесплатный аккаунт читать

```bash
flashdata account limits
```

- [Настройка ключа](https://flashdata.dev/ru/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 считывают конечные точки, а регистрация пробных версий также имеет свои собственные ограничения по ставкам; эти поля емкости не являются квотами на запросы в минуту.

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

- [Пределы регистрации в суде](https://flashdata.dev/ru/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/ru/docs/guides/agent-recovery/reference.md)

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

## Прочитать аккаунт

Окно по умолчанию — последние семь дней. Использование охватывает все ключи учетной записи, ограниченные источниками, к которым этот ключ может получить доступ.

### CLI

Используйте сохраненный доступ CLI. Для именованного профиля добавьте имя --profile к каждой команде. Эти чтения не тратят кредиты на запросы.

#### Бесплатный аккаунт читать

```bash
flashdata account usage
```

- [Настройка ключа](https://flashdata.dev/ru/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/ru/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"
```

