사용하지 않는 업로드 참조 선택
이 엔드포인트는 사용자 계정에 속한 업로드 참조 레코드를 삭제합니다. 해당 참조가 다음 용도로 더 이상 필요하지 않다고 확신할 때만 사용하세요: 증빙 자료 첨부 또는 보조 문서 첨부. 등록용 신원 정보나 주소는 삭제하지 않습니다.
외부 파일 ID를 가져올 수 있는 곳은 원래의 업로드 응답 또는 사용 가능한 업로드 목록입니다. 핸들러는 먼저 사용자 계정에서 해당 ID를 조회하며, 찾지 못하면 기존 공급자 ID로 조회합니다. 새로 연동할 때는 반환된 외부 참조를 그대로 사용해야 합니다. 요청 본문은 필요하지 않습니다.
명시적인 작업으로 삭제 요청
활성화된 MultiTEL API 계정을 사용하고, 해당 계정에 설정된 인증 정보와 IP 제한을 적용하여 HTTPS로 연결하세요. 애플리케이션에서 이를 명시적인 변경 작업으로 처리하도록 POST를 사용하세요:
curl --silent --show-error --request POST \
--user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/delete_encrypted_file/0123456789abcdef0123456789abcdef현재 핸들러는 HTTP 메서드를 제한하지 않으므로 GET 요청으로도 삭제가 실행될 수 있습니다. 이 URL을 일반적인 클릭 가능한 링크, 이미지, 북마크, 미리 보기 또는 미리 가져오기 대상으로 노출하지 마세요. 애플리케이션에서 명시적인 삭제 작업을 필수로 요구하고 자동으로 재시도하지 마세요.
결과의 의미와 한계 이해
HTTP 결과와 JSON의 status.code를 모두 확인하세요. 일반적인 성공 응답은 다음과 같습니다:
{
"status": {"code": 200, "msg": "Success"},
"response": []
}API 코드 404와 Failed, Not found가 반환되면 두 조회 모두에서 이 계정에 일치하는 참조를 찾지 못했다는 뜻입니다. 따라서 삭제를 반복하면 404가 반환될 수 있습니다. 경로 값의 앞뒤 공백은 제거됩니다. 이 처리에서는 참조의 유효 기간이 남아 있는지 또는 다른 단계에서 사용 중이 아닌지 확인하지 않으므로 삭제하기 전에 워크플로를 확인하세요.
핸들러는 데이터베이스 삭제를 시도한 후 실제 삭제 성공 여부를 확인하지 않고 성공을 보고합니다. 응답은 보고된 처리 결과로 받아들이고, 소거를 독립적으로 입증하는 근거로 간주하지 마세요. API로 생성된 유효 기간이 남아 있는 참조가 get_encrypted_files에 표시되었다면 해당 목록을 통해 계속 표시되는지 확인할 수 있습니다. 다만 목록에 없다는 것은 유효 기간이 만료되었다는 뜻일 수도 있습니다.
이 삭제는 완전한 데이터 소거가 아닙니다
핸들러는 업로드 참조 테이블에 삭제 작업을 실행합니다. 저장된 문서 내용 행, 로컬에 업로드된 파일, 첨부된 증빙 자료, 신원 정보, 보조 문서 또는 공급자가 보유한 사본을 명시적으로 삭제하지는 않습니다. 데이터베이스의 연쇄 삭제 및 데이터 보존 동작은 검증되지 않았습니다. 이 작업을 신원 확인 문서의 모든 사본을 삭제하거나 포괄적인 소거 요청을 충족하는 작업으로 사용자에게 설명하지 마세요.
로컬 참조가 삭제되면 해당 참조가 필요한 후속 첨부 단계가 실패할 수 있습니다. 이미 완료된 첨부 결과는 보존하고, 제출한 등록 정보를 변경할 때는 관련 신원 정보 또는 증빙 자료 관리 워크플로를 사용하세요.