inicis_find_email (이메일 찾기 - 본인인증 요청)
비로그인 사용자가 이메일(아이디)을 찾기 위해 이니시스 본인인증 요청 정보를 생성합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_find_email |
| Method |
POST |
| 인증 |
불필요 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| name |
string |
O |
사용자 이름 |
- |
| birth |
string |
O |
생년월일 |
YYYY-MM-DD |
| sex |
string |
O |
성별 |
male, female |
| phone |
string |
O |
전화번호 |
010-XXXX-XXXX |
요청 예시
{
"name": "홍길동",
"birth": "1990-01-15",
"sex": "male",
"phone": "010-1234-5678"
}
응답
성공 (200)
{
"message": "본인인증 정보 생성 성공",
"data": {
"mid": "이니시스_상점_ID",
"reqSvcCd": "01",
"mTxId": "REQ_abc1234567",
"successUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_find_email_success",
"failUrl": "https://asia-northeast3-construction24-test.cloudfunctions.net/inicis_fail",
"authHash": "sha256_hash_string",
"flgFixedUser": "Y",
"userName": "홍길동",
"userPhone": "01012345678",
"userBirth": "19900115",
"userHash": "sha256_user_hash_string"
}
}
응답 필드 설명
| 필드 |
타입 |
설명 |
| mid |
string |
이니시스 상점 ID |
| reqSvcCd |
string |
서비스 코드 (01: 휴대폰 본인인증) |
| mTxId |
string |
고유 거래번호 |
| successUrl |
string |
인증 성공 리다이렉트 URL |
| failUrl |
string |
인증 실패 리다이렉트 URL |
| authHash |
string |
보안 해시 |
| flgFixedUser |
string |
사용자 정보 고정 여부 ("Y") |
| userName |
string |
사용자 이름 |
| userPhone |
string |
전화번호 (숫자만) |
| userBirth |
string |
생년월일 (YYYYMMDD) |
| userHash |
string |
사용자 정보 해시 |
실패
| 코드 |
message |
원인 |
| 400 |
필드 검증 에러 |
필수 필드 누락 또는 형식 오류 |
| 500 |
"오류 발생: {에러 내용}" |
서버 내부 오류 |
참고
- 반환된 정보를 이니시스 본인인증 SDK에 전달하여 인증을 진행합니다.
- 인증 성공 시
inicis_find_email_success로 리다이렉트되어 이메일을 확인할 수 있습니다.
- 입력한 이름, 전화번호, 생년월일이 DB에 일치하는 사용자가 없어도 본인인증 정보는 생성됩니다. (인증 성공 후 사용자 조회 시 실패 처리)
- 관련 API: [[inicis_find_email_success]], [[send_password_reset_email]]