문서/빠른 시작

빠른 시작

5분 안에 처음부터 이메일 검증까지 완료해 보세요.

Markdown 보기 OpenAPI JSON

1. 계정 만들기

다음 주소에서 가입하세요: verimails.com/register (신용카드 불필요). 가입하면 무료 크레딧 100개가 바로 지급돼요.

2. API 키 발급받기

로그인한 뒤 대시보드 페이지에서 API 키를 복사하세요. 형식은 다음과 같아요:

text
ev_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
ℹ️
API 키는 비밀로 유지하세요. 클라이언트 측 코드나 공개 저장소에 절대 노출하지 마세요.

3. 첫 요청 보내기

POST 요청을 보낼 엔드포인트는 /api/verify/single 이며, 요청 본문에 이메일 주소를 담아 보내면 돼요:

bash
curl -X POST https://verimails.com/api/verify/single \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'
python
import requests

response = requests.post(
    "https://verimails.com/api/verify/single",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={"email": "user@example.com"}
)

data = response.json()
print(data["status"])         # valid
print(data["safe_to_send"])  # True
javascript
const response = await fetch("https://verimails.com/api/verify/single", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({ email: "user@example.com" })
});

const data = await response.json();
console.log(data.status);        // valid
console.log(data.safe_to_send);  // true
php
$ch = curl_init();
curl_setopt_array($ch, [
    CURLOPT_URL => "https://verimails.com/api/verify/single",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => [
        "Authorization: Bearer YOUR_API_KEY",
        "Content-Type: application/json"
    ],
    CURLOPT_POSTFIELDS => json_encode(["email" => "user@example.com"])
]);

$response = json_decode(curl_exec($ch), true);
echo $response["status"];        // valid
echo $response["safe_to_send"];  // 1

4. 응답 이해하기

성공 응답은 다음과 같아요:

json
{
  "email": "user@example.com",
  "status": "valid",
  "safe_to_send": true,
  "confidence_score": 0.95,
  "reason": "Verification completed",
  "domain": "example.com",
  "is_disposable": false,
  "is_role_based": false,
  "is_free": true,
  "is_catch_all": false,
  "verification_time_ms": 642
}

가장 중요한 필드는 status 와 safe_to_send예요. 연락할 주소인지 판단할 때는 safe_to_send: true 를 기본 필터로 사용하세요.

다음 단계