저장된 프로필 하나 조회
계정 내의 활성 로컬 등록 프로필을 UUID로 지정하여 가져옵니다. 반환되는 프로필 필드는 다음 엔드포인트와 동일한 제한된 항목입니다: documents. 통신사 확인을 갱신하거나 첨부된 증빙 서류를 반환하지는 않습니다.
프로필 요청
활성화된 MultiTEL API 계정과 해당 계정에 허용된 IP 주소를 사용하여 인증하세요. 예제에서는 환경 변수에 저장된 HTTP Basic 인증 정보를 사용합니다. HTTP 응답과 다음 JSON 값을 모두 확인하세요: status.code. HTTP 200 응답만으로는 성공 여부를 판단할 수 없습니다. 예제의 모든 값은 가상의 값입니다.
curl --silent --show-error --user "$API_USER:$API_PASSWORD" \
"https://api.multitel.net/v3/get_document/$DOCUMENT_UUID"DOCUMENT_UUID에 response.uuid 값을 설정하세요. 이 값은 다음 엔드포인트에서 가져옵니다: create_document. 또는 documents에서 가져온 response[].id 값을 설정하세요. 여기에 identity_id, address_id, 증빙 서류 ID 또는 전화번호를 사용하지 마세요. 요청 본문은 필요하지 않습니다.
프로필 응답
{
"status": {
"code": 200,
"msg": "Success"
},
"response": {
"id": "11111111111111111111111111111111",
"first_name": "Example",
"last_name": "Person",
"phone_number": "12025550123",
"id_number": "",
"birth_date": null,
"company_name": "",
"company_reg_number": "",
"vat_id": "",
"personal_tax_id": "",
"description": "Example profile",
"identity_type": "Personal",
"postal_code": "00000",
"city": "Example City",
"address": "1 Example Street",
"signature": "BASE64_PNG_SIGNATURE_DATA",
"date_created": "2026-10-23 16:00:00"
}
}반환되는 프로필 필드
이 필드 추출 결과에는 다음 항목이 포함됩니다: id, first_name, last_name, phone_number, id_number, birth_date, company_name, company_reg_number, vat_id, personal_tax_id, description, identity_type, postal_code, city, address, signature 및 date_created.
선택 항목의 값은 저장된 데이터에 따라 비어 있거나 null일 수 있습니다. 이 기존 형식의 추출 결과에는 email, 국가 선택 항목, identity_id, address_id, 업로드된 파일 참조, 증빙 서류 목록 및 확인 상태가 포함되지 않습니다. 이 엔드포인트는 증빙 서류 상태 확인이나 등록 승인을 위한 엔드포인트가 아닙니다. 반환된 신원 정보, 연락처 정보 및 서명 데이터는 비공개 정보로 취급하세요.
찾을 수 없는 경우와 재시도
API 코드 404와 다음 메시지: Failed, Not found 가 반환되면 해당 계정과 UUID에 일치하는 활성 프로필을 찾지 못했다는 뜻입니다. 계정, 식별자 및 프로필 삭제 여부를 확인하세요. 이 조회는 다른 계정의 프로필을 공개하지 않습니다.
조회에 성공하더라도 증빙 서류가 수락되었거나 전화번호가 활성화되었다는 뜻은 아닙니다. 생성 또는 첨부 요청의 결과가 불확실하여 후속 조치를 진행하는 경우, 상태를 변경하는 요청을 다시 보내기 전에 포털의 문서를 확인하세요.