이메일 유효검사

요청한 이메일 주소에 대한 유효성 여부 반환 API입니다.

캐릭터 인코딩은 UTF-8 을 기본으로 합니다.

비밀키는 ‘서비스콘솔’ – ‘Sub Account’ 생성 시 발급 받을 수 있습니다.

이메일 유효검사 API

POST https://atocqjpb6r.apigw.ntruss.com/email-validation/v1/send

Headers

Name	Type	Description
Authorization*	string	사용자ID;secret key
Content-Type*	string	application/json;charset=utf-8

Request Body

Name	Type	Description
to*	string	유효성 체크할 이메일 주소

200: OK 응답 반환 완료

Request Body 예시

{
    "to": "[e-mail]"
}

Response Body

키	타입	설명
to	string	받는 사람의 이메일 주소
validMailbox	string	받는 사람의 이메일 주소 상태 (true, false, unknown) (unknown 값일 경우 response에 reason 필드 값이 함께 반환됨)
validSyntax	boolean	수신자 이메일 주소 형태 체크
catchAll	boolean	사서함이 유효하지만 catch-all 설정이 있고 사서함을 확인할 수 없음(전송에 적합하지 않음)
didYouMean	string	유효한 대체 주소를 제안합니다.
roleBased	boolean	그룹메일과 같이 개인화 메일 수신에 적합하지 않은 주소 여부를 판단 합니다.
disposable	boolean	일회성 이메일 주소 여부
reason	string	유효한 사서함 상태를 알 수 없는 경우 이유가 제공됩니다. (reason 상세 참조)

reason 상세

값	설명
INBOX_FULL	사용자 할당량이 초과되었습니다. / 사용자 받은 편지함이 가득 찼습니다. / 사용자가 더 이상 요청을 수락하지 않습니다.
UNEXPECTED_FAILURE	메일 서버가 일시적인 오류를 반환했습니다.
THROTTLED	너무 많은 요청으로 인해 메일 서버가 일시적으로 우리를 허용하지 않습니다.
TIMED_OUT	메일 서버가 응답하는 데 더 오랜 시간이 걸렸습니다 / 네트워크에 지연이 있었습니다.
TEMP_REJECTION	메일 서버가 일시적으로 거부되었습니다.
UNABLE_TO_CONNECT	메일 서버에 연결할 수 없습니다.

성공

{
    "catchAll": false,
    "validMailbox": "false",
    "didYouMean": "[e-mail]",
    "validSyntax": true,
    "to": "[e-mail]"
}