Quickstart
Get started with email checker API in 5 minutes. Free API key, code examples, and email verification integration guide.
5분 만에 EmailVerify API를 시작하세요. 이 가이드에서는 첫 번째 이메일 주소를 인증하는 방법을 안내합니다.
사전 요구사항
시작하기 전에 다음이 필요합니다:
- EmailVerify 계정 (무료 가입)
- HTTP 요청에 대한 기본 지식 또는 지원하는 언어에 대한 이해
1단계: 계정 생성
- EmailVerify를 방문하여 시작하기를 클릭하세요
- 이메일 또는 Google/GitHub 계정으로 가입하세요
- 이메일 주소를 인증하세요
2단계: API 키 발급
- EmailVerify 대시보드에 로그인하세요
- API 키 섹션으로 이동하세요
- 새 키 생성을 클릭하세요
- 키에 설명적인 이름을 지정하세요 (예: "개발용", "프로덕션")
- API 키를 복사하고 안전하게 저장하세요
API 키를 클라이언트 측 코드나 공개 저장소에 노출하지 마세요. 환경 변수를 사용하여 키를 안전하게 저장하세요.
3단계: 첫 번째 이메일 인증
선호하는 방법을 선택하여 첫 번째 인증 요청을 보내세요:
curl -X POST https://api.emailverify.ai/v1/verify \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "test@example.com"}'const response = await fetch('https://api.emailverify.ai/v1/verify', {
method: 'POST',
headers: {
'Authorization': `Bearer ${process.env.EMAILVERIFY_API_KEY}`,
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'test@example.com',
}),
});
const result = await response.json();
console.log(result);import os
import requests
response = requests.post(
'https://api.emailverify.ai/v1/verify',
headers={
'Authorization': f'Bearer {os.environ["EMAILVERIFY_API_KEY"]}',
'Content-Type': 'application/json',
},
json={'email': 'test@example.com'}
)
result = response.json()
print(result)package main
import (
"bytes"
"encoding/json"
"fmt"
"net/http"
"os"
)
func main() {
data := map[string]string{"email": "test@example.com"}
body, _ := json.Marshal(data)
req, _ := http.NewRequest("POST",
"https://api.emailverify.ai/v1/verify",
bytes.NewBuffer(body))
req.Header.Set("Authorization", "Bearer "+os.Getenv("EMAILVERIFY_API_KEY"))
req.Header.Set("Content-Type", "application/json")
client := &http.Client{}
resp, _ := client.Do(req)
defer resp.Body.Close()
var result map[string]interface{}
json.NewDecoder(resp.Body).Decode(&result)
fmt.Println(result)
}<?php
$apiKey = getenv('EMAILVERIFY_API_KEY');
$ch = curl_init('https://api.emailverify.ai/v1/verify');
curl_setopt_array($ch, [
CURLOPT_POST => true,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => [
'Authorization: Bearer ' . $apiKey,
'Content-Type: application/json',
],
CURLOPT_POSTFIELDS => json_encode(['email' => 'test@example.com']),
]);
$response = curl_exec($ch);
curl_close($ch);
$result = json_decode($response, true);
print_r($result);4단계: 응답 이해하기
성공적인 인증은 다음과 같은 응답을 반환합니다:
{
"email": "test@example.com",
"status": "valid",
"result": {
"deliverable": true,
"valid_format": true,
"valid_domain": true,
"valid_mx": true,
"disposable": false,
"role": false,
"catchall": false,
"free": false,
"smtp_valid": true
},
"score": 0.95,
"credits_used": 1
}주요 응답 필드
| 필드 | 타입 | 설명 |
|---|---|---|
status | string | 전체 상태: valid, invalid, unknown, 또는 accept_all |
deliverable | boolean | 이메일이 메시지를 받을 수 있는지 여부 |
disposable | boolean | 임시/일회용 이메일인지 여부 |
role | boolean | 역할 기반 주소인지 여부 (info@, support@) |
catchall | boolean | 도메인이 모든 이메일을 수락하는지 여부 |
score | number | 신뢰도 점수 0~1 (높을수록 좋음) |
상태 값 설명
| 상태 | 의미 | 권장 조치 |
|---|---|---|
valid | 이메일이 존재하며 메시지를 받을 수 있음 | 발송 안전 |
invalid | 이메일이 존재하지 않거나 메시지를 받을 수 없음 | 목록에서 제거 |
unknown | 상태를 확인할 수 없음 | 나중에 재시도하거나 주의해서 사용 |
accept_all | 도메인이 모든 이메일을 수락 (캐치올) | 반송 여부 모니터링 |
5단계: SDK 사용 (권장)
더 쉬운 통합을 위해 공식 SDK 중 하나를 설치하세요:
npm install @emailverify/nodeimport { EmailVerify } from '@emailverify/node';
const client = new EmailVerify({
apiKey: process.env.EMAILVERIFY_API_KEY,
});
const result = await client.verify('test@example.com');
console.log(result.status); // 'valid'pip install emailverifyfrom emailverify import Client
import os
client = Client(api_key=os.environ['EMAILVERIFY_API_KEY'])
result = client.verify('test@example.com')
print(result.status) # 'valid'go get github.com/emailverify/go-sdkimport emailverify "github.com/emailverify/go-sdk"
client := emailverify.NewClient(os.Getenv("EMAILVERIFY_API_KEY"))
result, err := client.Verify(ctx, "test@example.com")
fmt.Println(result.Status) // "valid"composer require emailverify/php-sdkuse EmailVerify\Client;
$client = new Client(getenv('EMAILVERIFY_API_KEY'));
$result = $client->verify('test@example.com');
echo $result->status; // 'valid'<dependency>
<groupId>com.emailverify</groupId>
<artifactId>emailverify-java</artifactId>
<version>1.0.0</version>
</dependency>import com.emailverify.Client;
Client client = new Client(System.getenv("EMAILVERIFY_API_KEY"));
VerificationResult result = client.verify("test@example.com");
System.out.println(result.getStatus()); // "valid"다음 단계
첫 번째 이메일을 인증했으니 더 많은 기능을 살펴보세요:
API 레퍼런스
모든 엔드포인트를 포함한 완전한 API 문서
SDK 문서
각 SDK에 대한 상세 가이드
인증 유형
다양한 결과 유형 이해하기
AI 통합
Claude, ChatGPT 등과 함께 사용하기
일반적인 사용 사례
폼 검증
사용자 등록 시 실시간으로 이메일을 인증하세요:
const onEmailBlur = async (email) => {
const result = await client.verify(email);
if (result.status === 'invalid') {
showError('유효한 이메일을 입력해 주세요');
} else if (result.result.disposable) {
showError('일회용 이메일은 허용되지 않습니다');
}
};목록 정리
캠페인 발송 전에 이메일 목록을 정리하세요:
for email in email_list:
result = client.verify(email)
if result.status == 'valid':
clean_list.append(email)
else:
remove_list.append(email)리드 자격 심사
이메일 품질에 따라 리드를 점수화하세요:
const qualifyLead = (verificationResult) => {
let score = verificationResult.score * 50; // 기본 점수
if (!verificationResult.result.free) score += 20; // 비즈니스 이메일
if (!verificationResult.result.role) score += 15; // 개인 주소
if (!verificationResult.result.disposable) score += 15; // 영구 이메일
return score;
};도움이 필요하신가요?
- 구현 예제는 통합 가이드를 참조하세요
- 도움이 필요하시면 support@emailverify.ai으로 문의하세요