신원 또는 주소 증빙 첨부

이 단계는 신원 또는 주소가 생성되어 있고, 필요한 파일을 create_encrypt_files를 통해 선택한 증빙 유형으로 업로드한 후에 진행하세요. 현재 유효한 ID는 get_proof_types에서 가져오되, 요구 사항과 엔터티 범주에 맞는 ID를 사용하세요.

identity_id 및 address_id를 보관하세요. 이 값은 create_document에서 반환되며, 프로필 UUID는 별개의 식별자입니다. 새로 생성한 프로필에 나중에 주소 증빙을 첨부할 수 있는지는 아직 검토 중입니다. 주소가 거부되면 다시 시도하기 전에 포털에서 확인하거나 지원팀에 문의하세요.

증빙 연결 생성

활성화된 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 @proof-request.json \
  https://api.multitel.net/v3/create_proof

{
  "entity_type": "identities",
  "entity_id": "33333333333333333333333333333333",
  "proof_type_id": "11111111111111111111111111111111",
  "encrypted_file_ids": [
    "22222222222222222222222222222222"
  ]
}

요청 필드
필드	의미
`entity_type`	identities 또는 addresses를 사용하세요. 연결 대상과 업로드한 파일 모두에 맞는 범주를 선택하세요.
`entity_id`	계정이 소유한 신원 또는 주소의 ID입니다. 서류 처리 워크플로에서 반환된 식별자를 사용하세요. 전화번호나 관련 없는 서류 ID로 대체하지 마세요.
`proof_type_id`	선택한 증빙 유형의 ID입니다. 업로드 시 사용한 유형 및 요구 사항과 일치해야 합니다.
`encrypted_file_ids`	create_encrypt_files에서 반환한 파일 ID를 담은 비어 있지 않은 JSON 배열입니다. 파일은 동일한 계정에 속하고, 유효 기간이 지나지 않았으며, 엔터티 범주와 일치해야 합니다. 로컬 파일 경로 목록이 아닙니다.

폼 데이터도 허용됩니다. 이 경우 동일한 이름으로 반복되는 encrypted_file_ids[] 필드를 사용하세요. 실제 JSON 배열이나 폼 배열을 사용하는 것이 좋습니다. JSON으로 인코딩한 배열을 일반 스칼라 폼 값으로 보내지 마세요.

증빙 연결 ID 보관

{
  "status": {
    "code": 200,
    "msg": "Proof created successfully."
  },
  "response": {
    "id": "44444444444444444444444444444444",
    "entity_type": "identities",
    "entity_id": "33333333333333333333333333333333",
    "proof_type_id": "11111111111111111111111111111111",
    "proof_type_name": "Example identity proof"
  }
}

성공 응답은 증빙 연결이 생성되었음을 확인해 줍니다. 신원이나 주소의 승인, 국가별 모든 요구 사항에 대한 검증 또는 전화번호 활성화를 확인해 주는 것은 아닙니다.

오류 및 업로드한 파일의 만료

API 코드 500은 필수 입력 누락, 통신사 장애 및 유효하지 않은 통신사 응답에 사용됩니다. 코드 404는 대상이 현재 계정에 연결되어 있지 않거나, 증빙 유형이 유효하지 않거나, 해당 계정과 범주에 속하는 업로드 파일을 찾을 수 없거나 파일이 만료되었거나, 사용 가능한 파일 ID가 남아 있지 않을 때 사용됩니다. status.msg도 코드와 함께 확인하세요.

필수 파일이 만료되었다면 올바른 증빙 범주로 다시 업로드한 후 첨부하세요. 제공한 파일 중 하나라도 유효하지 않으면 이 핸들러는 증빙 생성 요청을 보내기 전에 처리를 중단합니다. 멱등성 키는 제공되지 않습니다. 시간 초과가 발생하면 첨부를 다시 시도하기 전에 포털에서 기존 서류를 확인하세요.