보충 서류 첨부하기

템플릿 기반 보충 서류 첨부하기

다음 기능에서 제공하는 템플릿을 사용하세요: get_supporting_document_templates. 계정에서 이미 소유하고 있는 신원 정보도 사용해야 합니다. 서류 파일은 다음 기능을 통해 업로드하세요: create_encrypt_files. 업로드할 때는 supporting_template_id를 지정하세요. 일반적인 신원 또는 주소 증명 서류 업로드는 다른 범주에 속하므로 대신 사용할 수 없습니다.

보충 서류 생성하기

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

curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
  --header 'Content-Type: application/json' \
  --data @supporting-request.json \
  https://api.multitel.net/v3/create_supporting_document

{
  "identity_id": "33333333333333333333333333333333",
  "template_id": "55555555555555555555555555555555",
  "encrypted_file_ids": [
    "66666666666666666666666666666666"
  ]
}

폼 데이터에서 encrypted_file_ids[] 필드를 반복해서 지정하는 방식도 허용됩니다. 이 첨부 엔드포인트에 파일 바이트 데이터를 보내지 마세요.

생성된 보충 서류

{
  "status": {
    "code": 200,
    "msg": "Supporting document created successfully."
  },
  "response": {
    "id": "77777777777777777777777777777777",
    "template_id": "55555555555555555555555555555555",
    "identity_id": "33333333333333333333333333333333",
    "template_name": "Example supporting template"
  }
}

이 응답은 보충 서류가 생성되었음을 확인하며, 규제상 승인이나 전화번호 활성화를 의미하지 않습니다. 상위 시스템의 리소스에서 사용하는 ‘영구적’이라는 용어는 보관 기간이나 삭제 정책에 대해 고객에게 보장하는 표현이 아닙니다.

오류 및 재시도

API 코드 500은 입력값 누락, 통신사 오류 또는 유효하지 않은 통신사 응답을 나타냅니다. 코드 404는 계정에 연결되지 않은 신원 정보, 유효하지 않은 템플릿, 누락되었거나 유효 기간이 지났거나 범주가 잘못된 업로드, 또는 사용 가능한 파일이 없는 경우를 나타냅니다. 다음 값을 확인하세요: status.msg. HTTP 200만으로는 성공 여부를 판단할 수 없습니다.

반환된 파일 참조의 유효 기간 내에 업로드와 첨부를 완료하세요. 처리 결과가 불확실한 응답을 받은 경우, 재시도하기 전에 포털에서 해당 신원 정보의 보충 서류를 확인하세요. 이 핸들러는 사용할 수 있는 멱등성 키를 제공하지 않습니다.