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

自動同期

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

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

"wait": true を追加すると、1回のリクエストで最新のデータが返ります:
ヘッダー Prefer: wait=25 でも同じ動作になります。 この呼び出しは最大25秒間待機します:
同期がすでに実行中の場合は、2つ目のジョブではなく、同じ sync_id が返ります。 200 または bank.data.updated を受け取ったあとは、保存しておいたカーソルを使って変更フィードを読み取ってください。 同期の結果は、後から get_sync_run で確認できます。

料金

自動同期とライブ同期は、どちらも接続の月額料金に含まれます。詳しくは料金をご覧ください。 ライブ同期によって料金が追加されることはありません。

銀行の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 を返します。

対応が必要なエラー

関連情報

最終更新日 2026年11月22日