이메일 검증 API란 무엇인가요?

이메일 검증 API를 사용하면 GET 요청을 통해 실시간으로 이메일 주소를 검증할 수 있습니다. 구문, MX 레코드, 블랙리스트를 확인하고 SMTP 검증을 수행합니다.

API를 사용하여 어떻게 인증하나요?

EmailVerify.io 대시보드에서 생성된 유효한 API 키를 제공해야 합니다. 키가 없거나 유효하지 않은 키가 있는 요청은 실패합니다.

이메일 유효성 검사 중에 어떤 검사가 수행되나요?

검사에는 정규식 유효성 검사, MX 레코드 조회, MX 블랙리스트 확인 및 SMTP 수준 메일함 검증이 포함됩니다.

API가 반환할 수 있는 오류 메시지는 무엇인가요?

일반적인 오류에는 유효하지 않은 API 키, 유효하지 않은 요청, 남은 크레딧 0 및 서버에 문제가 발생했을 때 다시 시도하십시오가 포함됩니다.

API를 통해 남은 크레딧을 확인할 수 있나요?

예. /check-account-balance/ 엔드포인트를 사용하면 API 상태, 일일 제한, 추천 크레딧 및 남은 크레딧을 확인할 수 있습니다.

이메일 검증 API 문서

즉시 검증 안내

소개

EmailVerify.io 단일 이메일 검증 API에 오신 것을 환영합니다! 이 API를 사용하면 단일 이메일 주소를 실시간으로 검증할 수 있으며, 간단한 요청만으로 이메일 커뮤니케이션의 정확성과 신뢰성을 보장합니다.

인증

API에 접근하려면 유효한 API 키가 필요합니다. 계정에 로그인한 후 API 섹션에서 개인 API 키를 생성할 수 있습니다. 이 키는 인증과 안전한 요청 수행에 필요합니다.

API 엔드포인트

다음 URL에서 고유 API 키와 검증할 이메일 주소를 대체하여 단일 이메일 주소를 검증합니다:

요청 URL 가져오기 (HTTPS)

https://app.emailverify.io/api/v1/[email protected]

성공 응답 예시

단일 이메일 요청이 성공적으로 처리되면 다음과 같은 응답을 받습니다:

URL

{
  "email": "[email protected]",
  "status": "valid",
  "sub_status": "permitted"
}

단일 이메일 검증에서 수행되는 체크

정규식 검증: 산업 표준 정규식 패턴을 사용하여 이메일 주소 구조를 확인하고, 오타나 형식 오류를 사전에 잡습니다.

MX 검증: 메일 교환(MX) 레코드를 확인하여 이메일 도메인이 메시지를 받을 수 있도록 설정되어 있는지 확인합니다. 이를 통해 도메인이 존재하고 활성 상태인지 보장합니다.

MX 블랙리스트 검증: 스팸 또는 악성 활동으로 알려진 블랙리스트에 있는 도메인을 식별하여 신뢰할 수 없는 이메일 목적지를 피하도록 돕습니다.

SMTP 검증: 수신자의 SMTP 서버에 실시간으로 핑을 보내 이메일 주소가 활성화되어 있고 메시지를 받을 수 있는지 확인합니다.

오류 응답

오류 메시지

설명

유효하지 않은 API 키

키가 비활성화되었거나 존재하지 않는 경우

잘못된 요청

API 엔드포인트의 잘못된 매개변수

남은 크레딧 0

사용자가 남은 크레딧이 없음

다시 시도해주세요

서버 측 문제로 요청이 실패한 경우

계정 잔액 확인

현재 계정 잔액(일일 및 즉시 크레딧)을 확인하려면 다음 GET 요청을 사용하세요.

GET 요청 URL (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

여기에서 <Your_API_Key>를 활성화된 API 키로 교체하세요.

응답 (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

대량 검증 안내

소개

EmailVerify.io 대량 이메일 검증 API에 오신 것을 환영합니다! 이 API를 사용하면 단일 요청으로 최대 5000개의 이메일 주소를 실시간으로 검증할 수 있으며, 이메일 커뮤니케이션의 정확성과 신뢰성을 보장합니다.

이 엔드포인트를 통해 한 번에 최대 5000개의 이메일 배치를 보낼 수 있습니다. 단일 이메일 검증을 원하시면 단일 이메일 검증기 엔드포인트를 사용하세요.

인증

API에 접근하려면 유효한 API 키가 필요합니다. 계정에 로그인한 후 API 섹션에서 개인 키를 생성할 수 있습니다. 이 키는 인증과 안전한 요청 수행에 필요합니다.

API 엔드포인트

다음 URL에서 고유 API 키와 검증할 이메일 주소를 대체하여 단일 이메일을 검증합니다.

POST 요청 URL (HTTPS)

https://app.emailverify.io/api/v1/validate-batch

POST 요청

다음 POST 요청을 통해 최대 5000개의 이메일 주소를 제출하여 검증할 수 있습니다.

POST 요청

{
  "title": "Task Name",
  "key": "Your_API_Key",
  "email_batch": [
    { "address": "[email protected]" },
    { "address": "[email protected]" },
    { "address": "[email protected]" }
  ]
}

성공 응답 예시

대량 검증 작업이 성공적으로 생성되면 다음과 같은 응답을 받습니다.

URL

{
  "status": "success",
  "task_id": "12345",
  "count_submitted": 3,
  "count_duplicates_removed": 0,
  "count_rejected_emails": 0,
  "count_processing": 3
}

GET 요청

이 엔드포인트는 이전에 생성된 대량 이메일 검증 작업의 결과를 가져옵니다. 작업이 완료되면 이메일 검증 결과를 포함하여 전체 상태를 확인할 수 있습니다.

GET 요청 URL

https://app.emailverify.io/api/v1/get-result-bulk-verification-task/?key=<Your_API_Key>&task_id=<Task_ID>

성공 응답 예시

검증 작업이 완료되면 다음과 같은 샘플 응답을 받습니다:

POST 요청

{
  "count_checked": "1",
  "count_total": "1",
  "name": "Task Name",
  "progress_percentage": "100%",
  "task_id": "1234",
  "status": "verified",
  "results": {
    "email_batch": [
      {
        "address": "[email protected]",
        "status": "invalid",
        "sub_status": "No dns entries"
      }
    ]
  }
}

대량 이메일 검증에서 수행되는 체크

정규식 검증: 산업 표준 정규식 패턴을 사용하여 이메일 주소 구조를 확인하고, 오타 및 형식 오류를 사전에 잡습니다.

MX 검증: 메일 교환(MX) 레코드를 확인하여 이메일 도메인이 메시지를 받을 수 있도록 설정되어 있는지 확인합니다. 도메인이 존재하고 활성 상태인지 보장합니다.

MX 블랙리스트 검증: 스팸 또는 악성 활동으로 알려진 블랙리스트에 있는 도메인을 식별하여 신뢰할 수 없는 이메일 목적지를 피하도록 돕습니다.

SMTP 검증: 수신자의 SMTP 서버에 실시간으로 핑을 보내 이메일 주소가 활성화되어 있고 메시지를 받을 수 있는지 확인합니다.

오류 응답

오류 메시지

설명

유효하지 않은 API 키

API 키가 비활성화되었거나 존재하지 않는 경우

잘못된 요청

요청에 잘못된 매개변수가 포함된 경우

남은 크레딧 0

사용자에게 사용 가능한 크레딧이 없는 경우

다시 시도해주세요

서버 측 문제로 요청이 실패한 경우

계정 잔액 확인

현재 계정 잔액(일일 및 즉시 크레딧)을 확인하려면 다음 GET 요청을 사용하세요.

GET 요청 URL (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance/?key=<Your_API_Key>

여기에서 <Your_API_Key>를 활성화된 API 키로 교체하세요.

응답 (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100,
  "remaining_credits": 15000
}

단일 이메일 찾기 안내

소개

단일 이메일 API를 사용하면 사람의 이름과 회사 도메인을 이용해 실시간으로 전문 이메일 주소를 찾을 수 있습니다. 빠르고 정확하며 신뢰할 수 있는 결과를 제공하도록 설계되어 리드 생성, 연락처 보강, 아웃리치에 이상적입니다.

이 엔드포인트는 이름과 도메인 정보를 제공하여 요청마다 이메일 주소를 검색할 수 있습니다. 쿼리에서 첫 번째로 발견된 결과가 응답으로 제공되며, 각 요청 시 10 크레딧이 차감됩니다.

인증

API 엔드포인트

URL

https://app.emailverify.io/api/v1/finder?key=YOUR_API_KEY&name=John&domain=example.com

이메일이 발견된 경우 예시 응답

이메일이 발견되면 동일한 응답을 받게 됩니다.

발견된 경우 응답

{
  "email": "[email protected]",
  "status": "found"
}

이메일이 발견되지 않은 경우 예시 응답

이메일이 발견되지 않으면 동일한 응답을 받게 됩니다.

발견되지 않은 경우 응답

{
  "email": "null",
  "status": "not_found"
}

이메일 찾기에서 수행되는 검증

조합 확인: 제공된 이름을 25가지 조합과 도메인 이름과 대조하여 유효한 이메일 주소를 생성하는 조합을 식별합니다.

MX 블랙리스트 검증: 스팸 또는 악성 활동으로 알려진 블랙리스트에 있는 도메인을 식별하여 신뢰할 수 없는 이메일 목적지를 피하도록 돕습니다.

SMTP 검증: 수신자의 SMTP 서버에 실시간으로 핑을 보내 이메일 주소가 활성화되어 있고 메시지를 받을 수 있는지 확인합니다.

오류 응답

오류 메시지

설명

유효하지 않은 API 키

키가 비활성화되었거나 존재하지 않는 경우

잘못된 요청

API 엔드포인트에 잘못된 매개변수가 있는 경우

남은 크레딧 0

사용 가능한 크레딧이 없는 경우

무료 도메인은 차단됨

사용자가 무료 도메인의 이메일을 찾으려 할 때

계정 잔액 확인

현재 계정 잔액(일일 및 즉시 크레딧)을 확인하려면 다음 GET 요청을 사용하세요.

GET 요청 URL (HTTPS):

https://app.emailverify.io/api/v1/check-account-balance?key=<Your_API_Key>

여기에서 <Your_API_Key>를 활성화된 API 키로 교체하세요.

응답 (JSON):

{
  "api_status": "enabled",
  "daily_credits_limit": 150,
  "referral_credits": 100
  "remaining_credits": 15000
}