Explorar documentación
Primeros pasos
Consulta la capacidad de tu cuenta, gestiona los límites de solicitudes y sigue el trabajo completado.
En esta página
Compruebe sus límites
Los límites siguen su cuenta y plan. Ejecute este cheque gratuito con la clave que enviará el trabajo; todas las claves de la cuenta comparten la misma capacidad.
Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.
flashdata account limitsRequiere Bash y cURL 7.76+. Si FLASHDATA_API_KEY ya está definida en tu entorno, omite el paso para introducirla. Ejecuta los comandos en la misma 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'
)Si FLASHDATA_API_KEY ya está definida, omite el paso para introducirla. Ejecuta los comandos en la misma 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 límite
Empieza con una solicitud en curso y aumenta la concurrencia dentro de los límites indicados. Los endpoints HTTP de lectura y el registro de pruebas tienen sus propios límites de frecuencia; estos campos de capacidad no son cuotas de solicitudes por minuto.
| Campo | Significado |
|---|---|
| limits.concurrency | Planifique el techo para el trabajo simultáneo, no un recuento de ranuras gratuitas. |
| limits.batchSize | Artículos máximos en una presentación por lotes. |
| limits.pendingJobs | Máximo trabajo pendiente para la cuenta. |
| current.pendingJobs | Cuento pendiente en el momento de la lectura. Puede cambiar antes de la presentación. |
Maneje una respuesta 429
Lea el cuerpo de error y el encabezado Retry-After. Para inspeccionar una cuenta gratuita, ejecute esto en un terminal Bash donde se establece FLASHDATA_API_KEY. Los encabezados están escritos a limits-headers.txt y la respuesta a 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.jsonEspera antes de volver a intentarlo.
Este ejemplo significa esperar al menos segundos 60. Retry-After también puede ser una fecha HTTP. Utilice el valor devuelto, no un retraso fijo.
HTTP/1.1 429 Too Many Requests
Retry-After: 60Elija la siguiente acción
| Situación | Medida |
|---|---|
| Capacidad plena | Reducir la concurrencia o esperar a que terminen los trabajos pendientes. |
| No Retry-After | Use el backoff capped con jitter y un límite de retry finito. |
| Registro limitado | Espera, luego vuelve a entrar con el mismo perfil, entrada y prueba. No cambie IPs. |
| Fecha límite de presentación | Inspeccione el funcionamiento o el trabajo existentes antes de volver a presentar; su resultado es desconocido. |
Uso de la cuenta
La ventana predeterminada es los últimos siete días. El uso cubre todas las teclas de cuenta, restringidas a las fuentes que esta clave puede acceder.
Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.
flashdata account usageReutiliza FLASHDATA_API_KEY desde el check anterior en el mismo 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'
)Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo 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
}Comprobación del trabajo y los créditos terminados
Lea los totales y bySource, a continuación, compare de y a con sus registros de tareas. CLI JSON envuelve la respuesta en datos. Las solicitudes recientes o los reembolsos pueden tomar tiempo para aparecer, incluso cuando la actualización es falsa.
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}Filtrar una fuente y rango de fecha
Sustitúyase las fechas de UTC con su período de presentación, hasta los días de 31. desde es inclusivo y hasta exclusivo; ambos se redondean hasta minutos. Esto lee el uso existente solamente.
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"