등록 증빙 파일 업로드

첨부하기 전에 업로드

하나의 증빙 또는 보조 서류 범주에 해당하는 파일을 업로드한 다음, 반환된 파일 ID를 다음 중 하나로 첨부하세요: create_proof 또는 create_supporting_document. 업로드만으로는 신원, 주소 또는 증빙 레코드가 생성되지 않으며, 전화번호 등록도 완료되지 않습니다. 먼저 최신 요건과 카탈로그 ID를 확인하세요.

선택자는 반드시 하나만 지정하세요. 신원·주소 증빙에는 proof_type_id를, 보조 서류에는 supporting_template_id를 지정하세요. 둘 다 보내지 마세요. 해당 MultiTEL 카탈로그에서 반환된 ID를 사용하고, 내부 구조에 의미를 부여하지 않는 불투명 식별자로 취급하세요.

업로드 요청

활성화된 MultiTEL API 계정과 해당 계정에 허용된 IP 주소를 사용하세요. 예제에서는 환경 변수에 있는 HTTP Basic 인증 정보를 사용합니다. 계정 유형에 맞는 인증 방식을 따르세요. 요청은 HTTPS로 보내세요. HTTP 응답과 JSON의 다음 값을 모두 확인하세요: status.code. HTTP 200으로도 애플리케이션 오류가 반환될 수 있습니다. 아래 예제는 가상의 예제입니다.

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --form-string "proof_type_id=$PROOF_TYPE_ID" \
  --form-string 'description=Identity proof' \
  --form 'files[0]=@./identity-proof.pdf' \
  https://api.multitel.net/v3/create_encrypt_files

파일 제한

이 핸들러는 파일을 최대 다섯 개, 총 20,000,000바이트까지 허용합니다. 이는 십진수 기준 바이트 제한이며, 20 MiB가 아닙니다. 인프라 또는 MIME 검증에 따라 추가 제한이 적용될 수 있습니다.

허용되는 확장자는 pdf, png, jpg, jpeg, gif, tiff, bmp, doc, docx, xls, xlsx, txt, rtf 및 csv입니다. 허용된 확장자라는 사실만으로 해당 파일이 선택한 등록 요건을 충족한다고 볼 수는 없습니다. 특히 tif는 이 허용 목록에 포함되지 않습니다.

반환된 모든 파일 확인

{
  "status": {
    "code": 200,
    "msg": "Encrypt file has been created successfully"
  },
  "response": {
    "entity_type": "identities",
    "document_category": "proof",
    "proof_type": "11111111111111111111111111111111",
    "ids": [
      {
        "id": "22222222222222222222222222222222",
        "name": "identity-proof.pdf",
        "expired_at": "2026-10-23 16:20:00"
      }
    ]
  }
}

첨부 요청에 사용할 수 있도록 각 response.ids[].id를 보관하세요. name은 반환된 원본 파일 이름을 나타냅니다. 파일 이름은 서로 다르게 지정하고, 반환된 파일 전체를 예상한 파일 목록과 대조하세요. 코드 200도 일괄 처리의 일부만 성공했음을 나타낼 수 있습니다. 필수 파일이 누락된 파일 묶음을 첨부하지 마세요.

entity_type의 값은 identities 또는 addresses가 증빙 업로드에 해당하며, supporting_documents가 보조 서류 업로드에 해당합니다. document_category의 값은 proof 또는 supporting입니다. 범용적인 이름을 사용하는 proof_type 응답 필드에는 보조 서류 업로드의 템플릿 참조도 담깁니다. 첨부에 사용할 원래의 supporting_template_id를 보관하세요.

신속하게 첨부

서비스는 업로드한 파일을 로컬에 저장한 시점으로부터 약 20분 후를 만료 시점으로 설정합니다. 첨부 시에는 파일이 동일한 계정에 속하는지, 만료로 표시되지 않았는지, 아직 만료 시점 전인지, 엔터티 범주가 올바른지 확인합니다. expired_at에는 이 응답에서 시간대 오프셋이 포함되지 않으므로 UTC라고 가정하지 마세요. 만료 직전에 작업하도록 예약하지 말고 신속하게 첨부하세요.

업로드 참조의 만료가 해당 시점에 저장된 모든 서류 사본이 삭제된다는 보장은 아닙니다. 서비스는 통신사 업로드를 위해 파일을 암호화하며, 서류 워크플로를 위해 원본 바이트를 보관합니다. 이를 클라이언트에서만 암호화하는 서비스나 데이터를 보관하지 않는 서비스로 취급하지 마세요. ID, 파일 이름 및 응답을 공개 로그에 기록하지 마세요.

오류 및 재시도

현재 핸들러는 서류 파일이 제공되지 않으면 API 코드 404를 사용합니다. 설명 검증, 선택자 누락 또는 충돌, 잘못된 증빙 유형 ID 또는 템플릿 ID, 파일 개수 또는 총 크기 제한, 저장소 문제, 업로드 실패에는 코드 500을 사용합니다. 다음 값을 확인하세요: status.msg. 잘못된 입력이 항상 코드 400으로 표시되는 것은 아닙니다.

여기서는 클라이언트가 지정할 수 있는 멱등성 키를 제공하지 않습니다. 응답이 유실되면 업로드를 반복하기 전에 서류 워크플로를 확인하세요. 다시 요청하면 새로운 파일 참조가 생성될 수 있습니다. 이 예제는 고객의 신원 확인 서류를 대상으로 실행한 것이 아닙니다.