ドキュメントを探す
はじめに
口座の容量を点検し、率の限界に応答し、完了した仕事を追跡して下さい。
このページの内容
制限をチェックする
アカウントとプランに従う制限。 作業を提出するキーでこの無料チェックを実行します。アカウントのすべてのキーは同じ容量を共有します。
保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。
flashdata account limitsBashと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(
: "${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& {
$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
}各限界を把握して下さい
同時に処理するリクエストを 1 件から始め、返された上限内で増やしてください。HTTP の読み取りエンドポイントや試用登録にも個別のレート制限があります。これらの処理容量の項目は、1 分あたりのリクエスト数ではありません。
| フィールド | 意味する |
|---|---|
| limits.concurrency | 同時作業のための天井を計画します。, 無料スロットのカウントではありません. |
| limits.batchSize | 1つのバッチ投稿の最大項目。 |
| limits.pendingJobs | アカウントの上限ジョブ。 |
| current.pendingJobs | 読み込み時に終わるカウント。 投稿前に変更できます。 |
429応答を扱います
エラーボディとRetry-Afterヘッダーを読みます。 無料アカウントの読み込みを検査するには、FLASHDATA_API_KEYが設定されているBashターミナルでこれを実行します。 ヘッダーは limits-headers.txt と 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.json再試行の前に待つ
この例では、少なくとも60秒を待ちます。 Retry-AfterはHTTPの日付であることができます。 返された値を使用して、固定遅延はありません。
HTTP/1.1 429 Too Many Requests
Retry-After: 60次のアクションを選択します。
| 投稿ナビゲーション | アクション |
|---|---|
| 容量 フル | finish にジョブを埋め込むのを待ちます。 |
| Retry-After なし | キャップされたバックオフをジッタとフィニトリトライの制限で使用してください。 |
| 参加申込期限 | その後、同じプロファイル、入力、および証拠を再試行します。 IP を切り替えないでください。 |
| 提出期限切れ | 退会前の既存の実行またはジョブを調べる。その結果は不明である。 |
アカウントの使用状況をお読みください
デフォルトのウィンドウは、最後の7日間です。 使用法は源に制限されるすべての記述のキーをアクセスできますカバーします。
保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。
flashdata account usageFLASHDATA_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/usage' || exit
printf '\n'
)FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。
& {
$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
}完成した仕事とクレジットの確認
合計とbySourceを読んで、タスクレコードとの違いを比較します。 CLI JSON は、データの応答をラップします。 更新時にも、最近のリクエストや返金は、falseです。
{
"scope": "account_authorized_sources",
"unit": "Credits",
"totals": {
"requests": 5,
"completed": 5,
"failed": 0,
"credits": 0.1
}
}ソースと日付範囲をフィルタリング
UTCの日付をレポート期間に置き換え、31までの日。 から 包括的な排他的です。 両方とも数分に丸められます。 既存の使用状況を読み取ります。
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"