메인 콘텐츠로 건너뛰기
DELETE
curl
Didit의 Delete a Bank Connection endpoint는 은행에 대한 접근을 중단하고, 해당 연결에 저장된 계좌, 잔액 및 거래 내역을 삭제합니다. 삭제는 되돌릴 수 없습니다. 삭제하지 않고 접근만 중단하려면 철회를 사용하십시오. 어떤 항목이 영향을 받고 어떤 항목이 영향을 받지 않는지는 데이터, 동의 및 삭제를 참조하십시오.

인증

x-api-key
string
header
필수

귀사 애플리케이션의 API 키입니다. Business Console의 Developers -> API keys에서 확인할 수 있습니다. 기본 키는 모든 권한을 가집니다. 명명된 키는 범위를 지정할 수 있습니다. 리소스별로 권한 없음, 읽기 또는 쓰기를 설정할 수 있고, 일부 워크플로나 승인된 세션으로 제한할 수 있으며, 허용된 IP 목록으로 제한할 수 있고, 만료일을 설정할 수 있습니다. 401은 키가 잘못되었거나, 취소되었거나, 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스 또는 작업에 대한 권한이 없거나, 요청이 IP 목록 밖의 주소에서 왔음을 의미합니다. 세션 경로에서 발생한 404는 세션이 키의 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 동영상 및 PDF URL을 null로 받으며, 세션 쓰기 권한이 없는 키는 세션 링크와 토큰을 null로 받습니다. 자세한 내용은 https://docs.didit.me/console/api-keys 를 참조합니다.

헤더

Idempotency-Key
string

한 작업을 위해 직접 정하는 선택적 재시도 안전 키입니다. 최대 255자이며 UUID를 사용할 수 있습니다. 같은 키, 엔드포인트, 쿼리, 본문으로 반복된 요청에는 첫 번째 응답이 같은 상태 코드와 같은 본문으로 반환되며, 다시 실행되거나 다시 과금되지 않습니다. 같은 키를 다른 엔드포인트, 쿼리 또는 본문과 함께 사용하면 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일