개발가이드

  • 개발가이드

이메일 유효성 검사

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

정보

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
이메일 형식과 도메인 MX 수신 가능 여부
제공자
String
우선순위가 가장 높은 MX 서버의 제공업체 도메인
도메인
String
이메일 서비스 도메인
도메인상태
String
이메일 서비스 도메인 상태
ok : 도메인이 제대로 작동하고 이메일을 받을 수 있습니다
invalid : 도메인이 호스트 이름을 준수하지 않습니다. 잘못된 구문이나 문자가 포함되어 있을 수 있습니다.
no-service : 도메인 소유자가 도메인에 메일 서비스가 없다고 표시했습니다('Null MX'라고도 함).
no-mail : 도메인에 유효한 MX 레코드가 없으므로 이메일을 받을 수 없습니다.
resolv-error : DNS 조회가 시간 초과되거나 일시적으로 실패했습니다.
무료이메일여부
Boolean
무료이메일 여부
일회용이메일여부
Boolean
일회용이메일 여부
개인용이메일여부
Boolean
개인용 메일 주소 형식 여부
(false: 일회용 도메인 또는 info, admin, support 등 공용 주소)
MX-IP
String | null
우선순위가 가장 높은 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=sample.user@gmail.com"
응답 예시

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