이메일 유효성 검사 API 문서
시작하기
모든 API 요청에는 API 키를 사용한 인증이 필요합니다. 대시보드에서 API 키를 찾을 수 있습니다.
헤더: "X-API-키: YOUR-API-키"단일 인증
단일 이메일 주소 또는 도메인의 유효성, 일회용 상태, 개인정보 보호 서비스 및 전달 가능성을 확인합니다.
엔드포인트
GET /v1/verify매개변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| input | string | 예 | 인증할 이메일 주소 또는 도메인(예: [email protected] 또는 example.com) |
apiDocs.responseFields
| 필드 | 설명 |
|---|---|
| valid | 이메일 형식이 올바른지 여부를 나타냅니다. |
| block | 이메일을 차단할지 여부를 나타냅니다(일회용, 개인 정보 보호, applePrivateEmail, 전달 가능 또는 catch_all이 참이면 참). |
| disposable | 이메일 주소가 임시 이메일 주소인지 일회용 이메일 주소인지 확인합니다. |
| privacy | 메일 서버가 이메일 별칭 또는 전달자를 사용하고 있는지 확인합니다. |
| applePrivateEmail | 이메일이 Apple 비공개 이메일 주소인지 여부를 나타냅니다. |
| deliverable | 사서함이 존재하고 이메일을 받을 수 있는지 확인합니다. |
| domain | 이메일 주소의 도메인 부분 |
| email_address | 이메일 주소 |
| catch_all | 도메인에 수신자 주소에 관계없이 모든 수신 이메일을 허용하는 포괄적 이메일 구성이 있는지 여부를 나타냅니다. |
| mx_found | 도메인에 유효한 메일 서버(MX 레코드)가 있는지 여부를 나타냅니다. |
| remaining_credits | 계정에 남아 있는 API 크레딧 수 |
응답 예시
{
"valid": true,
"block": false,
"disposable": false,
"privacy": false,
"applePrivateEmail": false,
"deliverable": true,
"domain": "example.com",
"email_address": "[email protected]",
"catch_all": false,
"mx_found": true,
"error": null,
"remaining_credits": 99
}코드 예제
curl "https://api.verify-email.app/v1/[email protected]" \
-H "X-API-Key: your-api-key"사용해 보기
엔드포인트를 테스트하려면 API 키가 필요합니다.
함께 사용해 보세요:
배치 확인
한 번의 요청으로 여러 이메일 주소 또는 도메인을 확인합니다(최대 100개 항목).
엔드포인트
POST /v1/verify/batch매개변수
| 이름 | 유형 | 필수 | 설명 |
|---|---|---|---|
| inputs | array of strings | 예 | 확인할 이메일 주소 또는 도메인의 배열 |
코드 예제
curl -X POST "https://api.verify-email.app/v1/verify/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
"inputs": [
"[email protected]",
"[email protected]"
]
}'사용해 보기
엔드포인트를 테스트하려면 API 키가 필요합니다.
다른 도메인으로 시도해 보세요: