메인 콘텐츠로 건너뛰기
POST
curl

개요

하나 이상의 사용자 엔티티를 삭제합니다. 사용자 레코드는 영구적으로 제거됩니다. 사용자의 인증 세션은 이 endpoint의 적용 대상이 아니며, 사용자와의 연결만 해제된 상태로 남습니다. 이러한 세션은 세션 삭제 또는 세션 일괄 삭제로 삭제해야 합니다. 거래도 적용 대상이 아니므로 거래 일괄 삭제로 삭제해야 합니다.

사용 시기

  • 잊힐 권리 요청(GDPR / CCPA)
  • QA 과정에서 테스트 사용자 정리
  • 자체 플랫폼에서 제거된 사용자의 프로비저닝 해제

참고 사항

  • vendor_data 값 목록, didit_internal_id 값 목록 또는 delete_all: true를 받을 수 있습니다. 두 목록은 함께 사용할 수 있으며, OR 조건으로 결합됩니다.
  • 이 endpoint는 delete_all을 필터로 좁히지 않습니다. 콘솔의 filter_* 일괄 파라미터는 400으로 거부되므로, 범위를 좁히려던 의도와 달리 애플리케이션의 모든 사용자가 삭제되는 일은 없습니다. 예외는 filter_has_approved_sessions와 filter_has_declined_sessions입니다. 이 두 매개변수는 거부되지도 적용되지도 않으므로 delete_all과 함께 보내지 마십시오.
  • 전부 성공하거나 전부 실패합니다. 선택한 사용자에 대한 삭제를 완료할 수 없으면 아무도 삭제되지 않으며, 동일한 요청을 안전하게 다시 보낼 수 있습니다.
  • 멱등성이 있습니다. 같은 목록을 다시 보내면 첫 실행 후에는 deleted: 0이 반환됩니다.
  • 항목별 보고서가 아니라 삭제된 건수만 반환합니다. 일치하는 항목이 없는 값은 오류 없이 건너뜁니다. 보낸 식별자 수와 deleted를 비교하려면 중복을 제거한 목록을 보내십시오. 반복된 식별자는 한 번만 계산되기 때문입니다.
  • 삭제 시 webhook은 발생하지 않습니다. webhook은 사용자 상태 및 데이터 변경 시 발생하며 삭제 시에는 발생하지 않습니다. 따라서 삭제 신호가 필요한 연동은 자체 시스템에 이를 직접 기록해야 합니다.
  • 사용자와 연결된 인증 세션은 이 endpoint로 삭제되지 않습니다. 세션은 사용자와의 연결만 해제된 상태로 남으므로, 문서, 얼굴, 미디어는 세션 자체를 삭제해야만 제거됩니다.
  • retain_face_embeddings(불리언, 기본값 false)와 face_retention_days(1~3650)는 삭제된 사람마다 이미지가 없는 생체 인식 템플릿 하나를 중복 감지 목적으로 지정된 일수 동안 보관하도록 명시적으로 선택하는 옵션입니다. 그 사람에 관한 다른 어떤 것도 보관되지 않습니다. 두 옵션을 모두 생략하면 사용자와 함께 템플릿도 삭제됩니다. retain_face_embeddings: true 없이 face_retention_days를 보내거나, face_retention_days 없이 retain_face_embeddings: true를 보내면 face_retention_days에 대해 400이 반환됩니다.
  • retain_face_embeddings를 true로 설정하지 않으면, 사용자에 연결된 생체 인식 템플릿은 사용자를 삭제하기 전에 모두 제거됩니다. 생체 정보 저장소를 사용할 수 없어 템플릿을 제거할 수 없으면 호출은 503을 반환하고, 요청에 포함된 사용자는 아무도 삭제되지 않습니다. 같은 요청을 다시 보내면 작업이 완료됩니다.

확정된 규제 보고서의 데이터

선택한 사람 중 한 명이라도 확정된 규제 보고서가 있는 케이스에 속해 있으면 요청 전체가 409를 반환하고 아무것도 삭제되지 않습니다. 응답에는 code: in_filed_report가 포함되며, 각 보고서의 이름이 표시되어 콘솔에서 열어볼 수 있습니다.
각 보고서를 보고서 삭제로 삭제한 다음 같은 요청을 다시 보내십시오. 다른 선택 사람이 여전히 보고서에 포함되어 있다면, 해당 사람을 목록에서 빼는 것만으로는 충분하지 않습니다.

이미 진행 중인 삭제

한 사람은 한 번에 하나의 요청으로만 삭제됩니다. 선택한 사람 중 한 명을 다른 요청이 아직 삭제하고 있으면, 이 요청은 최대 몇 초 동안 기다린 후 code: subject_deletion_in_progress와 함께 409를 반환하며 아무것도 삭제하지 않습니다.
다른 삭제 작업이 끝나면 같은 요청을 다시 보내십시오. 이미 삭제된 사람은 더 이상 일치하지 않으므로, 재시도에서는 남은 대상만 삭제됩니다.

권한

애플리케이션의 활성 API 키는 모두 이 endpoint를 호출하는 데 사용할 수 있습니다. Didit API 키는 역할 범위가 아닌 애플리케이션 범위로 지정됩니다. 콘솔의 역할 및 권한(delete:users 등)은 콘솔에서 사람이 할 수 있는 작업을 결정하며, Management API 트래픽에는 적용되지 않습니다. 이 endpoint를 호출할 수 있는 사람은 애플리케이션의 API 키를 읽을 수 있는 사람으로 제한하십시오.

관련 문서

인증

x-api-key
string
header
필수

Business Console의 Developers -> API keys에서 발급받은 귀하 애플리케이션의 API 키입니다. 기본 키는 전체 접근 권한을 갖습니다. 이름이 지정된 키는 리소스별 none, read, write 범위로 권한을 제한할 수 있으며 특정 워크플로나 승인된 세션, IP 주소 목록, 만료일 등으로 제한할 수도 있습니다. 401은 키가 잘못되었거나 폐기되었거나 만료되었음을 의미합니다. 403은 키가 전송되지 않았거나, 키에 해당 리소스나 작업에 대한 접근 권한이 없거나, 요청이 허용된 IP 목록 외부 주소에서 발생했음을 의미합니다. 세션 경로에서의 404는 해당 세션이 키의 허용 워크플로 또는 상태 범위를 벗어났음을 의미합니다. 미디어 접근 권한이 없는 키는 이미지, 비디오, PDF URL을 null로 수신하며, 세션 write 권한이 없는 키는 세션 링크와 token을 null로 수신합니다. https://docs.didit.me/console/api-keys 를 참고하십시오.

본문

application/json

vendor_data_list, didit_internal_id_list 또는 delete_all: true를 제공하세요. 두 목록은 결합될 수 있으며 OR 조건으로 처리됩니다. delete_all이 true이면 우선 적용되며 두 목록은 모두 무시됩니다.

vendor_data_list
string[]

삭제할 귀하 고유의 식별자 목록이며, 전송된 내용과 정확히 일치합니다.

didit_internal_id_list
string<uuid>[]

삭제할 Didit 내부 사용자 ID입니다. 생성 및 조회 endpoint에서 반환된 didit_internal_id입니다.

delete_all
boolean
기본값:false

true인 경우 애플리케이션의 모든 사용자를 삭제합니다.

retain_face_embeddings
boolean
기본값:false

중복 감지를 위해 삭제된 각 개인의 이미지가 없는 생체 인식 템플릿을 face_retention_days 동안 보존할지 여부에 대한 귀하의 명시적 선택입니다. 해당 개인에 관한 다른 모든 정보는 삭제됩니다. 사용자와 함께 템플릿을 삭제하려면 생략하거나 false를 전달하십시오. true인 경우 face_retention_days가 필수입니다.

face_retention_days
integer

retain_face_embeddings가 true일 때 이미지가 없는 생체 인식 템플릿이 보존되는 일수입니다. 해당 설정과 함께 필수이며, 설정 없이 전달되면 face_retention_days에 대해 400 오류로 거부됩니다.

필수 범위: 1 <= x <= 3650
예시:

365

응답

사용자가 삭제되었습니다. 실제로 삭제된 사용자 수를 반환합니다.

deleted
integer

삭제된 사용자 수(일치하지 않는 vendor_data 값은 제외됨)입니다.

마지막 수정일 2026년 11월 7일