# Limites de taxa e uso

Inspecione a capacidade da conta, responda aos limites de taxa e rastreie o trabalho concluído.

Referência canônica: https://flashdata.dev/pt/docs/guides/usage-and-limits
2026-11-04 por FlashData

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

## verificação seus limites

Limites seguem sua conta e plano. Execute esta verificação gratuita com a chave que enviará o trabalho; todas as chaves da conta compartilham a mesma capacidade.

### CLI

Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.

#### Conta livre lê

```bash
flashdata account limits
```

- [Prepare uma chave](https://flashdata.dev/pt/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Requer Bash e cURL 7.76+. Pule a chave secreta se seu ambiente já fornecer FLASHDATA_API_KEY. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

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

#### Leia a conta 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

Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo terminal.

#### Defina a tecla · skip se já configurado

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

#### Leia a conta 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>

### Entender cada limite

Comece com um pedido de voo, e depois aumente dentro dos limites relatados. HTTP ler os pontos finais e registro de teste também têm seus próprios limites de taxa, estes campos de capacidade não são pedidos-por-minuto quotas.

| Campo | O que quer dizer? |
| --- | --- |
| limits.concurrency | Planeje teto para trabalho simultâneo, não uma contagem de vagas grátis. |
| limits.batchSize | Máximo de itens em um lote de submissão. |
| limits.pendingJobs | Máximas tarefas pendentes para a conta. |
| current.pendingJobs | Contagem pendente no momento da leitura. Pode mudar antes da submissão. |

- [Limites de registro de teste](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md#trial-limits)

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

## Lidar com uma resposta 429

Leia o corpo de erro e o cabeçalho Retry-After. Para inspecionar uma conta livre lida, execute isso em um terminal Bash onde FLASHDATA_API_KEY está definido. Os cabeçalhos estão escritos para limits-headers.txt e a resposta para limits.json.

### Capturar status, cabeçalhos e corpo · 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>

### Espere antes de tentar novamente

Este exemplo significa esperar pelo menos segundos 60. Retry-After também pode ser uma data HTTP. Use o valor devolvido, não um atraso fixo.

#### Cabeçalhos de resposta ilustrativa

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


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

### Escolha a próxima ação

| Situação | Ação |
| --- | --- |
| Capacidade completa | Reduzir a concorrência ou esperar que os trabalhos pendentes terminem. |
| Retry-After | Use o reboco com nervosismo e um limite de retentação finito. |
| Registro limitado | Espere, então tente novamente com o mesmo perfil, entrada e prova. Não mude de IP. |
| Tempo de envio esgotado | Inspecione a execução ou o trabalho existente antes de reenviar, seu resultado é desconhecido. |

- [Recupere uma tarefa interrompida](https://flashdata.dev/pt/docs/guides/agent-recovery/reference.md)

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

## Leia o uso da conta

A janela padrão são os últimos sete dias. O uso cobre todas as chaves da conta, restritas às fontes que essa chave pode acessar.

### CLI

Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.

#### Conta livre lê

```bash
flashdata account usage
```

- [Prepare uma chave](https://flashdata.dev/pt/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

Reutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.

#### Leia a conta 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

Reutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.

#### Leia a conta 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>

### verificação o trabalho completo e os créditos

Leia os totais e bySource, e compare de e para com seus registros de tarefas. CLI JSON envolve a resposta em dados. Pedidos recentes ou reembolsos podem levar tempo para aparecer, mesmo quando atualizado é false.

#### Excerto de resposta ilustrativa

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

- [Inspecione um trabalho em History](https://flashdata.dev/app/jobs)
- [Entenda as acusações](https://flashdata.dev/pt/docs/guides/credits-and-billing/reference.md)

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

### Filtrar uma fonte e intervalo de datas

Substitua as datas da UTC por seu período de notificação, até os dias da 31 de é inclusiva e exclusiva, ambas são arredondadas para minutos. Isso só diz uso existente.

#### Janela de relatórios de exemplo

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

