浏览文档
开始使用
检查账户容量、处理限流并跟踪已完成工作。
本页内容
检查限额
限额取决于账户与套餐。使用实际提交任务的密钥运行此免费检查,账户下所有密钥共享容量。
需要 Bash 与 cURL 7.76+。若环境已提供 FLASHDATA_API_KEY,跳过隐藏输入提示。在同一终端运行读取命令。
设置密钥 · 已配置可跳过
# 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读取账户 JSON
(
: "${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'
)若已设置 FLASHDATA_API_KEY,跳过隐藏输入提示。在同一终端运行读取命令。
设置密钥 · 已配置可跳过
# 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读取账户 JSON
& {
$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
}理解各项限制
先保持一个执行中请求,再在返回限额内增加并发。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。 |
| 提交超时 | 重发前检查已有运行或任务,当前结果不确定。 |
读取账户用量
默认窗口为最近七天。用量覆盖账户全部密钥,但仅包含当前密钥获授来源。
在同一终端复用前面检查时设置的 FLASHDATA_API_KEY。
读取账户 JSON
(
: "${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'
)在同一终端复用前面检查时设置的 FLASHDATA_API_KEY。
读取账户 JSON
& {
$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
}检查完成量与 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"