MINARA

이메일 인증 코드 발송

POST /v1/security/email-code: 업스트림 `POST /auth/email/code`를 호출하여 사용자가 새 인증 코드를 받을 수 있게 합니다.

POST /v1/security/email-code

업스트림 POST /auth/email/code를 호출하여 사용자가 새 인증 코드를 받을 수 있게 합니다. TOTP를 사용 중지하거나 연결 해제할 때는 인증 앱 코드와 이 이메일 코드를 함께 사용하며, 인증 앱이 없는 계정의 출금에서는 이 코드가 유일한 2차 인증 수단입니다. emailType은 필수이며 enableAuthApp, disableAuthApp, unlinkGoogle, withdrawal 중 하나여야 합니다. 업스트림은 용도별로 코드를 저장하므로 잘못된 용도로 발급한 코드는 절대 검증되지 않습니다. 수신 주소는 인증된 계정에서 읽으며 요청에 담긴 값은 사용하지 않습니다.

메서드POST
경로/v1/security/email-code
인증GATEWAY_AUTH_TOKEN이 설정된 경우 Authorization: Bearer <token> 필요
분류auth

요청 본문

{ "emailType": "disableAuthApp" }

응답 본문

{ "success": true }

참고

400 email_type_invalid: 용도가 없거나 허용된 값이 아닙니다. 409 account_email_unavailable: 계정에 코드를 보낼 이메일 주소가 없습니다. 429 captcha_required: 짧은 시간에 여러 번 요청해 업스트림이 발송을 거부했습니다. 잠시 후 다시 시도하세요. 업스트림은 주소별 시간당 한도를 넘기면 메일을 조용히 버리며, 응답만으로는 실제 발송과 구분할 수 없습니다. UI의 재발송 대기 시간이 유일한 완화 수단입니다.

목차