Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Limites de taxa e uso

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.

Conta livre lê
flashdata account limits

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.

CampoO que quer dizer?
limits.concurrencyPlaneje teto para trabalho simultâneo, não uma contagem de vagas grátis.
limits.batchSizeMáximo de itens em um lote de submissão.
limits.pendingJobsMáximas tarefas pendentes para a conta.
current.pendingJobsContagem 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.

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

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/1.1 429 Too Many Requests
Retry-After: 60

Escolha a próxima ação

SituaçãoAção
Capacidade completaReduzir a concorrência ou esperar que os trabalhos pendentes terminem.
Retry-AfterUse o reboco com nervosismo e um limite de retentação finito.
Registro limitadoEspere, então tente novamente com o mesmo perfil, entrada e prova. Não mude de IP.
Tempo de envio esgotadoInspecione 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.

Conta livre lê
flashdata account usage

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
{
  "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.

Janela de relatórios de exemplo
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"