> ## Documentation Index
> Fetch the complete documentation index at: https://docs.didit.me/llms.txt
> Use this file to discover all available pages before exploring further.

# 今すぐ同期：銀行データをオンデマンドで更新

> 1回のAPIを呼び出して接続の最新の銀行データを今すぐ取得し、結果を待てます。銀行の1日あたりの上限と429が返す内容も確認できます。Diditで利用可能。

ディディットの「Sync Now」は、1回のAPI呼び出しで、いつでも接続先の銀行から接続の最新データを読み取ります。
ライブ同期は接続の月額料金に含まれているため、追加料金は一切かかりません。
唯一の制限は銀行側のものです。

## 自動同期

* 最初の同期は、ユーザーが接続したときに実行されます。
* その後、有効な継続中の接続はすべて、銀行によって異なりますが1日1〜4回自動的に同期されます。回数は接続の`sync.frequency_per_day`で、次回の予定時刻は`sync.next_sync_at`で確認できます。
* 銀行がユーザーの操作なしで1日により多くの読み取りを許可している場合は、ライブ同期用に、1日少なくとも2回は必ず残されます。
* 同期で変更が保存されると`bank.data.updated`が届きます。その後、カーソルを使って[変更フィード](https://docs.didit.me/ja/standalone-apis/bank-transactions-sync.md)を読み取ります。
* 失敗した同期はバックオフを伴って再試行されます。失敗が24時間続くと、接続は`sync.status: failing`のまま`active`の状態で残り、`bank.sync.failed`が送信されます。再び正常に動作すると、`bank.sync.recovered`が送信されます。
* 銀行がユーザーに再度サインインを求めると、接続は`renewal_required`になります。

## 1回の呼び出しで今すぐ同期

`"wait": true` を追加すると、1回のリクエストで最新のデータが返ります:

```bash theme={null}
curl -X POST https://verification.didit.me/v3/bank/connections/$CONNECTION_ID/refresh/ \
  -H "x-api-key: $DIDIT_API_KEY" -H "content-type: application/json" \
  -d '{ "wait": true }'
```

ヘッダー `Prefer: wait=25` でも同じ動作になります。
この呼び出しは最大25秒間待機します:

| 結果 | 意味 |
| - | - |
| `200` | 同期が完了しました。レスポンスボディには、同期の `outcome`、アカウントごとの `added`、`modified`、`removed` の件数、および `balances_changed` が含まれます。 |
| `202` | 25秒以内に銀行から応答がなかった場合、または待機を指定しなかった場合に返ります。レスポンスボディには `sync_id` が含まれます。`get_sync_run` で同期を読み取るか、`bank.sync.completed` を購読してください。`bank.data.updated` は、同期によって変更が保存された場合にのみ送信されます。 |

```json theme={null}
{
  "id": "d4a9e7b2-1c58-4f03-96ab-5e2d8c7f0b14",
  "trigger": "requested",
  "status": "succeeded",
  "outcome": "succeeded",
  "balances_changed": true,
  "results": [{ "resource": "transactions", "outcome": "succeeded", "added": 3, "modified": 0, "removed": 1 }]
}
```

同期がすでに実行中の場合は、2つ目のジョブではなく、同じ `sync_id` が返ります。
`200` または `bank.data.updated` を受け取ったあとは、保存しておいたカーソルを使って変更フィードを読み取ってください。
同期の結果は、後から [`get_sync_run`](https://docs.didit.me/ja/standalone-apis/bank-sync-run-get) で確認できます。

## 料金

自動同期とライブ同期は、どちらも接続の月額料金に含まれます。詳しくは[料金](https://docs.didit.me/ja/getting-started/bank-verification-pricing.md)をご覧ください。
ライブ同期によって料金が追加されることはありません。

## 銀行の1日あたりの上限

銀行は、本人が立ち会わないままデータを取得できる回数を制限しています。
欧州の規制では、銀行は口座ごとに本人不在でのアクセスを1日4回の読み取りまでに制限できます。
これは上限であり、保証ではありません。銀行によってはこれより少ない回数しか許可しない場合もあれば、より多くの回数を認める場合もあります。

* 自動同期とライブ同期は同じ枠を共有し、自動スケジュールが1日の最後の2回の読み取りを使うことはありません。
* 接続の`sync.live_syncs_left_today`には、本日残りのライブ同期の回数が示されます。`sync.budgets[]`には各枠が表示され、`scope`（`connection`または`account`）、`resource`、`limit`、`remaining`、`resets_at`が含まれます。
* 更新や再接続のために本人がBank Linkを利用している間は、読み取りに制限はかかりません。
* その日の枠を使い切ると、APIは`429 refresh_limit_reached`を返します。レスポンスには`Retry-After`ヘッダー（枠がリセットされるまでの秒数）と、`live_syncs_left_today`および`budgets`を含む`sync`オブジェクトが含まれます。その秒数だけ待ち、その間は自動同期に任せてください。
* APIのレート制限は別に適用されます。アプリケーションごとに毎分600回の読み取りと300回の書き込みが上限で、`X-RateLimit-*`ヘッダーで確認できます。

## データの鮮度を確認する

* 接続と各アカウントの `sync.last_synced_at` は、Didit が最後に銀行からデータを取得した時刻です。あなたが最後にデータを読み取った時刻ではありません。
* 取引の読み取りは両方とも `X-Bank-Last-Synced-At` を返します。

## 対応が必要なエラー

| エラー | 意味 | 対応 |
| - | - | - |
| `429 refresh_limit_reached` | 銀行の予算を使い切っています。 | `Retry-After`で示された時間待ち、自動同期に任せてください。 |
| `409 connection_not_active` | 接続が`active`ではありません。 | 接続のステータスを確認してください。 |
| `409 consent_expired` | 同意が終了しています。 | [同意を更新する](https://docs.didit.me/ja/use-cases/renew-bank-consent.md)。 |

## 関連情報

* [会計向けの継続的な銀行フィード](https://docs.didit.me/ja/use-cases/bank-data-for-accounting.md)
* [銀行のWebhook](https://docs.didit.me/ja/core-technology/bank-verification/webhooks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.