Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Límites de tarifas y uso

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.

Consultar la cuenta gratis
flashdata account limits

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.

CampoSignificado
limits.concurrencyPlanifique el techo para el trabajo simultáneo, no un recuento de ranuras gratuitas.
limits.batchSizeArtículos máximos en una presentación por lotes.
limits.pendingJobsMáximo trabajo pendiente para la cuenta.
current.pendingJobsCuento 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.

Estado de captura, cabeceras y cuerpo · 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

Espera 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.

Cabeceras de respuesta ilustrativa
HTTP/1.1 429 Too Many Requests
Retry-After: 60

Elija la siguiente acción

SituaciónMedida
Capacidad plenaReducir la concurrencia o esperar a que terminen los trabajos pendientes.
No Retry-AfterUse el backoff capped con jitter y un límite de retry finito.
Registro limitadoEspera, luego vuelve a entrar con el mismo perfil, entrada y prueba. No cambie IPs.
Fecha límite de presentaciónInspeccione 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.

Consultar la cuenta gratis
flashdata account usage

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.

Illustrative response extractopt
{
  "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.

Ejemplo de ventana de presentación de informes
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"