개발가이드

  • 개발가이드

이메일 유효성 검사

이메일의 유효성 여부를 검사합니다.

정보

Method
URL
POST
https://apick.app/rest/check_email_valid

요청

Header
이름
필수
설명
CL_AUTH_KEY
O
인증키(MD5)
FormData
이름
타입
필수
설명
email
String
O
이메일 주소

응답

Body
이름
타입
설명
data
Object
조회 데이터
이메일
String
검색한 이메일
유효성
Boolean
해당 이메일 유효성 여부
제공자
String
메일서비스 제공업체 도메인
도메인
String
이메일 서비스 도메인
도메인상태
String
이메일 서비스 도메인 상태
ok : 도메인이 제대로 작동하고 이메일을 받을 수 있습니다
invalid : 도메인이 호스트 이름을 준수하지 않습니다. 잘못된 구문이나 문자가 포함되어 있을 수 있습니다.
no-service : 도메인 소유자가 도메인에 메일 서비스가 없다고 표시했습니다('Null MX'라고도 함).
no-mail : 도메인에 유효한 MX 레코드가 없으므로 이메일을 받을 수 없습니다.
mx-invalid : MX 레코드에 유효하지 않거나 준수하지 않는 호스트 이름 값이 포함되어 있습니다.
mx-bogon : MX 레코드가 Bogon IP 주소를 가리킴
resolv-error : MX 레코드가 유효한 IP 주소로 확인되지 않습니다.
무료이메일여부
Boolean
무료이메일 여부
일회용이메일여부
Boolean
일회용이메일 여부
개인용이메일여부
Boolean
개인용메일 여부
(false : 기관용, 공용이메일)
MX-IP
String
MX 서버의 첫 번째 확인된 IP 주소
success
Integer
과금 여부
0: 실패
1: 성공
3: 실패(timeout)
api
Object
API 호출 공통 데이터
success
Boolean
API 서버 정상 응답 여부
cost
Integer
API 호출 요금
ms
Integer
API 응답 시간
pl_id
Integer
API 결제 로그 ID

예시

요청 예시

curl -k -X POST "https://apick.app/rest/check_email_valid" \
-H "CL_AUTH_KEY: $API_KEY" \
-F "email=helloworld@codeline.kr"
응답 예시

{
    "data": {
        "이메일": "helloworld@codeline.kr",
        "유효성": true,
        "제공자": "google.com",
        "도메인": "codeline.kr",
        "도메인상태": "ok",
        "무료이메일여부": false,
        "일회용이메일여부": false,
        "개인용이메일여부": true,
        "MX-IP": "172.253.118.26",
        "success": 1
    },
    "api": {
        "success": true,
        "cost": 5,
        "ms": 248,
        "pl_id": 405
    }
}
현재 페이지 북마크