개발자

GET/v3/delete_document/{uuid}

등록 프로필 삭제

데이터를 삭제하는 레거시 작업을 이해하고, 제한된 범위의 결과를 확인하세요.

이 페이지의 내용
  1. 등록 프로필을 신중하게 삭제하기
  2. 데이터를 삭제하는 레거시 요청
  3. 반환되는 결과
  4. 삭제 여부와 확인 범위 검증

등록 프로필을 신중하게 삭제하기

이 레거시 작업은 계정이 소유한 통신사 측 신원 정보와 주소의 삭제를 시도한 다음, 로컬 프로필을 삭제된 것으로 표시합니다. 정확한 로컬 프로필 UUID를 documents에서 확인하고 포털에서 검토한 후 이 작업을 호출하세요. 이 작업은 증빙만 삭제하거나 이전 작업을 되돌리는 작업이 아닙니다.

데이터를 삭제하는 레거시 요청

허용된 IP 주소에서 활성화된 MultiTEL API 계정으로 인증하세요. 예제에서는 환경 변수에 저장된 인증 정보와 가상 데이터를 사용합니다. HTTP 응답뿐 아니라 JSON의 status.code 및 status.msg도 확인하세요.

현재 포털은 GET을 사용하여 이 작업을 호출합니다. 이 HTTP 메서드를 사용하더라도 데이터가 변경됩니다. 링크, 이미지, 상태 점검, 브라우저 미리 가져오기, 크롤러 또는 자동 재시도에 이 URL을 절대 사용하지 마세요. 연동 구현에서는 사용자가 명시적으로 삭제를 결정해야만 이 작업을 실행하도록 하세요.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/v3/delete_document/$DOCUMENT_UUID"

DOCUMENT_UUID는 생성 시 uuid로, 프로필을 다시 조회할 때 id로 반환되는 로컬 프로필 식별자입니다. 신원 정보 ID, 주소 ID 또는 전화번호가 아닙니다. 요청 본문은 사용하지 않습니다.

반환되는 결과

{
  "status": {
    "code": 200,
    "msg": "Success"
  },
  "response": []
}

API 코드 404와 함께 메시지 Failed, Not found가 반환되면 이 계정에서 해당 프로필 UUID를 찾지 못했다는 뜻입니다. 200이 반환되면 핸들러가 완료 응답 단계에 도달했다는 뜻이며, 통신사가 신원 정보와 주소를 삭제했거나 로컬 데이터베이스 업데이트가 성공했음을 입증하지는 않습니다.

삭제 여부와 확인 범위 검증

현재 핸들러는 통신사 측 삭제나 로컬 업데이트의 결과를 확인하지 않습니다. 성공 응답을 받은 후에는 활성 documents 결과에 해당 프로필이 없고 get_document에서 찾을 수 없음이 반환되는지 확인하세요. 이러한 확인으로 알 수 있는 것은 로컬에서의 조회 가능 여부뿐입니다. 상위 통신사에서 삭제되었음을 입증하지는 않습니다.

이 엔드포인트는 일반적인 개인정보 삭제 API가 아닙니다. 업로드된 파일, 증빙, 보충 서류, 로그, 백업 또는 기타 보관 기록이 삭제되었음을 확인해 주지 않습니다. 상위 통신사에서의 삭제 확인이나 데이터 삭제 요청은 지원팀에 문의하세요. 일부만 처리된 결과를 확인하는 대신 삭제 작업을 반복 호출하지 마세요.