メインコンテンツへスキップ
DELETE
curl
Didit の銀行接続削除エンドポイントは、銀行へのアクセスを停止し、その接続に保存された口座、残高、取引を削除します。 削除は元に戻せません。 接続を削除せずにアクセスを停止するには、取り消しを使用してください。 削除の影響を受けるもの、受けないものについては、データ、同意、削除を参照してください。

承認

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。

レスポンス

削除を受け付けました。

削除を受け付けました。接続の銀行データを削除しており、その間データ操作は 409 connection_not_active を返します。接続を読み取ると、この erasure ステータスを持つ最小限のレコードが返されます。

id
string<uuid>
必須

接続ID。

erasure
object
必須

依頼した削除の進行状況。

最終更新日 2026年11月22日