コンテンツへスキップ
JA
APIキーを取得する
ドキュメントを探す

はじめに

レート制限と使用量

口座の容量を点検し、率の限界に応答し、完了した仕事を追跡して下さい。

このページの内容

制限をチェックする

アカウントとプランに従う制限。 作業を提出するキーでこの無料チェックを実行します。アカウントのすべてのキーは同じ容量を共有します。

保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。

無料アカウントの読み込み
flashdata account limits

各限界を把握して下さい

同時に処理するリクエストを 1 件から始め、返された上限内で増やしてください。HTTP の読み取りエンドポイントや試用登録にも個別のレート制限があります。これらの処理容量の項目は、1 分あたりのリクエスト数ではありません。

フィールド意味する
limits.concurrency同時作業のための天井を計画します。, 無料スロットのカウントではありません.
limits.batchSize1つのバッチ投稿の最大項目。
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の日付であることができます。 返された値を使用して、固定遅延はありません。

Illustrative レスポンスヘッダ
HTTP/1.1 429 Too Many Requests
Retry-After: 60

次のアクションを選択します。

投稿ナビゲーションアクション
容量 フルfinish にジョブを埋め込むのを待ちます。
Retry-After なしキャップされたバックオフをジッタとフィニトリトライの制限で使用してください。
参加申込期限その後、同じプロファイル、入力、および証拠を再試行します。 IP を切り替えないでください。
提出期限切れ退会前の既存の実行またはジョブを調べる。その結果は不明である。

アカウントの使用状況をお読みください

デフォルトのウィンドウは、最後の7日間です。 使用法は源に制限されるすべての記述のキーをアクセスできますカバーします。

保存したCLIアクセスを使用します。 名前付きプロファイルの場合は、--profile NAME を各コマンドに追加します。 これらはクエリクレジットを消費しません。

無料アカウントの読み込み
flashdata account usage

完成した仕事とクレジットの確認

合計とbySourceを読んで、タスクレコードとの違いを比較します。 CLI JSON は、データの応答をラップします。 更新時にも、最近のリクエストや返金は、falseです。

Illustrative 応答の抜粋
{
  "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"