사용 가능한 업로드 참조 목록 조회
이 엔드포인트는 등록 서류 업로드 후에 첨부에 사용할 수 있는 참조를 찾아야 할 때 사용합니다. 활성화된 MultiTEL API 계정에 설정된 인증 정보와 IP 제한을 적용하여 HTTPS로 접속하세요. 목록의 범위는 해당 계정으로 한정됩니다.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
https://api.multitel.net/v3/get_encrypted_files요청 본문이나 쿼리 매개변수는 필요하지 않습니다. 핸들러는 API를 통해 생성된 업로드 레코드 중 만료 플래그가 설정되지 않았고 만료 시각이 서버의 현재 시각보다 이후인 항목을 목록으로 반환합니다. 페이지 나누기, 검색 또는 정렬 매개변수는 제공하지 않습니다. 계정에 있는 모든 신원 정보, 증빙 서류 또는 과거 서류의 목록이 아닙니다.
서류의 바이트 데이터가 아닌 메타데이터 확인
HTTP 결과와 JSON의 status.code를 확인하세요. 성공한 응답은 response에 배열을 포함합니다. 결과가 없으면 빈 배열이 반환되며, 계정이 없다는 오류를 뜻하지 않습니다. 예제에 사용된 메타데이터와 식별자는 가상의 값입니다.
{
"status": {"code": 200, "msg": ""},
"response": [{
"id": "0123456789abcdef0123456789abcdef",
"proof_type": "abcdef0123456789abcdef0123456789",
"entity_type": "addresses",
"description": "Example address proof",
"file_name": "example-document.pdf",
"date": "2026-10-01 12:00:00"
}]
}| 필드 | 의미 |
|---|---|
id | 외부에서 사용하는 업로드 참조입니다. 해당 첨부 요청에 사용할 때 값을 그대로 복사하세요. 식별자를 직접 계산하거나 신원 정보, 주소 또는 템플릿의 ID로 대체하지 마세요. |
proof_type | 기록된 유형 참조가 있으면 마스킹된 해당 값이며, 없으면 빈 문자열입니다. 증빙 서류 업로드에서는 증빙 유형을 나타내고, 보조 서류 업로드에서는 동일한 키에 템플릿 참조가 기록됩니다. 둘을 구분하려면 entity_type을 확인하세요. 업로드 ID가 아닙니다. |
entity_type | identities, addresses 또는 supporting_documents 등 기록된 첨부 범주입니다. 해당 범주에 맞는 첨부 워크플로를 선택하세요. |
description | 저장된 업로드 설명입니다. |
file_name | 원래 파일 이름입니다. 다운로드 URL이 아닙니다. |
date | 기록된 생성 시각으로, 서버에서 시간대 오프셋 없이 형식을 지정한 값입니다. |
응답에는 서류의 바이트 데이터, 저장소 URL 또는 만료 시각이 포함되지 않습니다. 최초 업로드 응답의 expired_at 값을 보관하세요. 업로드 목록을 조회해도 유효 기간이 연장되거나 신원 정보에 첨부되지 않으며, 통신 사업자의 승인을 받았음을 증명하지도 않습니다.
참조가 만료되기 전에 첨부
용도에 맞게 증빙 서류 첨부 또는 보조 서류 첨부 워크플로를 사용하세요. 현재 업로드 워크플로에서 발급하는 참조의 유효 기간은 짧습니다. 이 목록에 참조가 표시되었다는 이유만으로 첨부를 미루지 마세요. 목록 조회와 첨부 사이에 참조가 만료되거나 사용할 수 없게 될 수 있습니다. 성공했다고 가정하지 말고 첨부 응답에 따라 처리하세요.
예상과 달리 목록이 비어 있으면 계정을 확인하고, 업로드가 만료되었거나 다른 워크플로를 통해 생성되었는지 확인하세요. 최초 업로드 및 첨부 결과를 확인하지 않은 채 같은 서류를 자동으로 다시 업로드하지 마세요.
개인정보 보호
파일 내용이 없어도 파일 이름과 설명으로 사람이나 서류를 식별할 수 있습니다. 접근을 제한하고 응답 전체를 로그에 기록하지 마세요. 사용하지 않은 로컬 업로드 참조를 삭제하려면 업로드 참조 삭제를 참조하세요. 해당 작업은 서류를 포괄적으로 삭제하는 서비스가 아닙니다.