# レート制限と使用量

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

キャニシニカル参照: https://flashdata.dev/ja/docs/guides/usage-and-limits
レビュー: FlashData による 2026-11-04

<a id="limits"></a>

## 制限をチェックする

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

### CLI

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

#### 無料アカウントの読み込み

```bash
flashdata account limits
```

- [キーを設定する](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

BashとcURL 7.76+が必要です。 環境がすでにFLASHDATA_API_KEYを供給している場合は、隠れたキープロンプトをスキップします。 同じターミナルで読み取りコマンドを実行します。

#### 既に設定されている場合はキー・スキップを設定します。

```bash
# 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

```bash
(
: "${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'
)
```


### PowerShell 7

FLASHDATA_API_KEYが既に設定されている場合は、隠しキープロンプトをスキップします。 同じターミナルで読み取りコマンドを実行します。

#### 既に設定されている場合はキー・スキップを設定します。

```powershell
# 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

```powershell
& {
  $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
}
```



<a id="capacity"></a>

### 各限界を把握して下さい

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

| フィールド | 意味する |
| --- | --- |
| limits.concurrency | 同時作業のための天井を計画します。, 無料スロットのカウントではありません. |
| limits.batchSize | 1つのバッチ投稿の最大項目。 |
| limits.pendingJobs | アカウントの上限ジョブ。 |
| current.pendingJobs | 読み込み時に終わるカウント。 投稿前に変更できます。 |

- [トライアル登録制限](https://flashdata.dev/ja/docs/guides/agent-onboarding/reference.md#trial-limits)

<a id="rate-limit"></a>

## 429応答を扱います

エラーボディとRetry-Afterヘッダーを読みます。 無料アカウントの読み込みを検査するには、FLASHDATA_API_KEYが設定されているBashターミナルでこれを実行します。 ヘッダーは limits-headers.txt と limits.json への応答に書かれています。

### キャプチャ状況、ヘッダ、ボディ・Bash / cURL

```bash
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
```


<a id="retry-example"></a>

### 再試行の前に待つ

この例では、少なくとも60秒を待ちます。 Retry-AfterはHTTPの日付であることができます。 返された値を使用して、固定遅延はありません。

#### Illustrative レスポンスヘッダ

```http
HTTP/1.1 429 Too Many Requests
Retry-After: 60
```


<a id="retry-actions"></a>

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

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

- [中断されたタスクを回復する](https://flashdata.dev/ja/docs/guides/agent-recovery/reference.md)

<a id="usage"></a>

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

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

### CLI

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

#### 無料アカウントの読み込み

```bash
flashdata account usage
```

- [キーを設定する](https://flashdata.dev/ja/docs/guides/api-keys-and-permissions/reference.md#store)

### Bash / cURL

FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。

#### 口座を読む JSON

```bash
(
: "${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'
)
```


### PowerShell 7

FLASHDATA_API_KEYを同一ターミナルの初期チェックから再利用します。

#### 口座を読む JSON

```powershell
& {
  $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
}
```



<a id="usage-result"></a>

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

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

#### Illustrative 応答の抜粋

```json
{
  "scope": "account_authorized_sources",
  "unit": "Credits",
  "totals": {
    "requests": 5,
    "completed": 5,
    "failed": 0,
    "credits": 0.1
  }
}
```

- [Historyでジョブを調べる](https://flashdata.dev/app/jobs)
- [費用の把握](https://flashdata.dev/ja/docs/guides/credits-and-billing/reference.md)

<a id="usage-filter"></a>

### ソースと日付範囲をフィルタリング

UTCの日付をレポート期間に置き換え、31までの日。 から 包括的な排他的です。 両方とも数分に丸められます。 既存の使用状況を読み取ります。

#### レポートウィンドウの例

```bash
flashdata account usage --source google_search --from "2026-11-01T00:00:00Z" --to "2026-11-04T00:00:00Z"
```

