跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

速率限制与用量

检查账户容量、处理限流并跟踪已完成工作。

本页内容

检查限额

限额取决于账户与套餐。使用实际提交任务的密钥运行此免费检查,账户下所有密钥共享容量。

使用 CLI 已保存的访问。使用命名配置时,在每条命令后追加 --profile NAME。这些读取不消耗查询 Credits。

免费账户读取
flashdata account limits

理解各项限制

先保持一个执行中请求,再在返回限额内增加并发。HTTP 读取端点及试用注册各有速率限制,这些容量字段不是每分钟请求配额。

字段含义
limits.concurrency套餐同时执行上限,不是空闲槽位数。
limits.batchSize一次批量提交的最大项目数。
limits.pendingJobs账户最大待处理任务数。
current.pendingJobs读取时的待处理计数,提交前可能发生变化。

处理 429 响应

读取错误正文及 Retry-After 请求头。在已设置 FLASHDATA_API_KEY 的 Bash 终端运行下方免费账户读取。响应头保存到 limits-headers.txt,响应保存到 limits.json。

保存状态、响应头及正文 · 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

等待后再重试

此示例表示至少等待 60 秒。Retry-After 也可以是 HTTP 日期,应使用返回值而非固定等待时间。

响应头示例
HTTP/1.1 429 Too Many Requests
Retry-After: 60

选择下一步操作

情况操作
容量已满降低并发,或等待待处理任务结束。
缺少 Retry-After采用带抖动、有上限的退避,并限制重试次数。
注册受限等待后复用同一配置、输入和凭证重试,不更换 IP。
提交超时重发前检查已有运行或任务,当前结果不确定。

读取账户用量

默认窗口为最近七天。用量覆盖账户全部密钥,但仅包含当前密钥获授来源。

使用 CLI 已保存的访问。使用命名配置时,在每条命令后追加 --profile NAME。这些读取不消耗查询 Credits。

免费账户读取
flashdata account usage

检查完成量与 Credits

读取 totals 和 bySource,并将 from、to 与任务记录核对。CLI JSON 将响应包装在 data 中。近期请求或退款可能延迟显示,即使 updating 为 false。

响应节选示例
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}

按来源及日期筛选

将 UTC 日期替换为统计时段,最多 31 天。包含 from,不包含 to,时间均向下取整到分钟。此命令仅读取已有用量。

统计时段示例
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"