Explorar documentação
Primeiros passos
Inspecione a capacidade da conta, responda aos limites de taxa e rastreie o trabalho concluído.
Nesta página
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.
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.
flashdata account limitsRequer 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.
# 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(
: "${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'
)Pule o prompt de chave escondida se FLASHDATA_API_KEY já está definido. Execute os comandos de leitura no mesmo terminal.
# 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& {
$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
}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. |
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.
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.jsonEspere 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.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Escolha 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. |
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.
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.
flashdata account usageReutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.
(
: "${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'
)Reutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.
& {
$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
}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.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}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.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"