自動同期
- 最初の同期は、ユーザーが接続したときに実行されます。
- その後、有効な継続中の接続はすべて、銀行によって異なりますが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秒間待機します:
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を返します。