change_email (이메일 변경 요청)
새 이메일 주소로 6자리 인증 코드를 발송합니다.
기본 정보
| 항목 |
값 |
| URL |
https://asia-northeast3-construction24-test.cloudfunctions.net/change_email |
| Method |
POST |
| 인증 |
Firebase ID Token 필요 |
요청
Body
| 필드 |
타입 |
필수 |
설명 |
검증 |
| token |
string |
O |
Firebase ID Token |
- |
| new_email |
string |
O |
변경할 새 이메일 주소 |
이메일 형식 |
요청 예시
{
"token": "eyJhbGci...",
"new_email": "newemail@example.com"
}
응답
성공 (200)
{
"message": "인증 코드가 발송되었습니다."
}
실패
| 코드 |
message |
원인 |
| 401 |
"본인인증이 되지 않았습니다." |
본인인증 미완료 사용자 |
| 400 |
"현재 사용 중인 이메일과 동일합니다." |
현재 이메일과 같은 이메일 입력 |
| 400 |
"필드 'new_email'의 형식이 올바르지 않습니다. (타입: email)" |
이메일 형식 오류 |
| 404 |
"존재하지 않는 유저입니다." |
사용자 DB에 없음 |
| 409 |
"이미 등록된 이메일입니다." |
다른 사용자가 사용 중인 이메일 |
| 500 |
"메일 전송 중 오류 발생: {에러}" |
이메일 발송 실패 |
| 500 |
"서버 오류 발생: {에러}" |
서버 오류 |
참고
- 본인인증이 완료된 사용자만 이메일 변경이 가능합니다.
- 인증 코드는 6자리 숫자이며 5분간 유효합니다.
- Firestore와 Firebase Auth 모두에서 이메일 중복을 확인합니다.
- 인증 코드는 새 이메일 주소로 발송됩니다.
- 인증 코드 확인은
change_email_verify에서 진행합니다.
- 관련 API: [[change_email_verify]]