メインコンテンツへスキップ
POST
curl
Didit の「Renew a Bank Connection」エンドポイントは、接続の更新リンクを作成します。これは mode: renew を指定してリンクを作成するためのショートカットです。 接続IDとすべてのアカウントIDは変わりません。 残り30日を超えている間は、409 renewal_not_needed で応答します。 詳細は銀行同意の更新を参照してください。

承認

x-api-key
string
header
必須

お客様のアプリケーションのAPIキーです。Business Console の Developers -> API keys から取得できます。プライマリーキーはすべてのアクセス権を持ちます。名前付きキーは範囲を制限できます。リソースごとに none、read、write を指定でき、一部のワークフローや承認済みセッションに限定できます。IPアドレスのリストや有効期限も設定できます。401 はキーが誤っている、取り消されている、または期限切れであることを意味します。403 はキーが送信されていない、そのリソースまたはアクションへのアクセス権がない、またはリクエストがIPリストに含まれないアドレスから送信されたことを意味します。セッションのルートでの404 は、セッションがキーのワークフローまたはステータスの範囲外にあることを意味します。メディアへのアクセス権がないキーでは、画像、動画、PDFのURLが null で返されます。セッションの書き込み権限がないキーでは、セッションリンクとトークンが null で返されます。詳しくは https://docs.didit.me/console/api-keys を参照してください。

ヘッダー

Idempotency-Key
string

1回の操作に対して任意で指定する、再試行の安全性を確保するためのキーです。255文字まで指定でき、UUIDも使用できます。同じキー、エンドポイント、クエリ、ボディで繰り返されたリクエストには、最初のレスポンスが同じステータスと同じボディで返され、2回目は実行も課金も行われません。同じキーを別のエンドポイント、クエリ、ボディで使うと 409 idempotency_key_reused が返されます。最初のリクエストがまだ処理中の場合は、Retry-After 付きの 409 idempotency_key_in_progress が返されます。失敗したリクエスト(4xx または 5xx)は保存されないため、同じキーで再送できます。キーは、APIキーとアクセストークンのどちらで呼び出す場合でも、お使いのアプリケーションに属します。詳しくは 再試行と冪等性 を参照してください。

Required string length: 1 - 255

パスパラメータ

id
string<uuid>
必須

接続ID。

ボディ

application/json

任意。更新リンクの設定。残りは接続から取得されます。

redirect_url
string<uri>

処理の最後にブラウザを遷移させる先。サンドボックスアプリケーションでは、localhost、127.0.0.1、[::1] の平文 http アドレスは登録不要です。それ以外のアドレスは 400 redirect_url_not_registered を返します。その他のアドレスの登録はまだ利用できません。

Maximum string length: 2048
allowed_origins
string<uri>[]

受け付けますが、現在は使用されません。Didit の埋め込み型Bank Linkのために予約されており、まだ提供されていません。HTTPSオリジン、最大50件。

Maximum array length: 50
language
string
Maximum string length: 16
Pattern: ^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})?$
expires_in
integer
デフォルト:3600

有効期間(秒)。300~86400。

必須範囲: 300 <= x <= 86400

レスポンス

更新リンク。

1人の利用者に対するBank Linkの1回の実行です。銀行に接続する場合、または接続を更新する場合に使用します。リンクはget_linkで自分で確認してください。ブラウザから送られたIDは決して信頼しないでください。

id
string<uuid>
必須

リンクの識別子。

mode
enum<string>
必須
利用可能なオプション:
connect,
renew
access
enum<string>
必須
利用可能なオプション:
one_time,
ongoing
status
enum<string>
必須

リンクの状態です。completed、cancelled、expired、failed は最終状態です。

利用可能なオプション:
created,
opened,
connecting,
completed,
cancelled,
expired,
failed
url
string<uri> | null
必須

利用者を誘導するホスト型ページです。リンクの作成時にのみ返されます。トークンは保存されないため、後続の読み取りでは null になります。

client_token
string | null
必須

Diditの埋め込み型Bank Link用のトークンです。まだリリースされていないため、現時点ではurlを開いてください。リンク作成時にのみ返され、以降の読み取りではnullになります。用途は1つだけで有効期間は短く、個人データは含まれません。絶対にログに記録しないでください。

expires_at
string<date-time>
必須

未使用のリンクが無効になる日時。

connection_id
string<uuid> | null
必須

status が completed になると、このリンクによって作成または更新された接続。

check_id
string<uuid> | null
必須

ownership.compare に none 以外を指定した場合の、このリンクの所有構造の判定結果です。

reused
boolean
必須

本人がこれらの口座をすでに正確に共有している場合(duplicates: reuse)、リンクは既存の接続の更新として完了し、その際 true になります。二重に課金されることはありません。

error
object | null
必須

status が failed の場合に、リンクが失敗した理由。それ以外は null。

quote
object
必須

リンクの料金。作成時に固定されます。請求される料金は見積もりの料金です。読み取りでは課金されません。

vendor_data
string | null
必須

リクエストで指定したあなたの参照情報。

最終更新日 2026年11月22日