이 영상 소개

이 영상의 응답은 실제 API 응답을 줄인 것입니다. API 키, 대량 검증, 파일 검증에는 유료 계정이 필요합니다.

영상 스크립트

1. 00:00첫 요청

   첫 요청은 /verify/single로 보내는 POST입니다. JSON 필드 하나, email만 보냅니다. API 키는 BV-API-KEY 헤더에 넣으세요. 요청은 이게 전부입니다. 키는 서버의 환경 변수에 보관하고, 클라이언트 코드에는 절대 넣지 마세요. 키를 만들려면 유료 계정이 필요하며, 크레딧을 구매하면 사용할 수 있습니다.

2. 00:24응답 읽기

   지원용 주소에 대한 실제 응답입니다. 먼저 status를 보세요. role로 나옵니다. support는 사람이 아니라 공용 메일함 이름이기 때문입니다. score는 0.6입니다. 고정된 규칙에서 나온 값이며 확률이 아닙니다. 그러니 score가 아니라 status로 분기하세요. is_deliverable은 true이므로 메일 서버가 이 주소를 수락했습니다. is_catch_all도 true이므로 이 도메인은 어떤 주소든 받습니다. status는 role이 차지하고, 나머지는 플래그에 그대로 나타납니다. reason은 이유를 코드 하나로 알려 줍니다. 여기서는 catch-all deliverable입니다.

3. 01:02credits_used가 0인 이유

   문서에는 모든 코드를 정리한 페이지가 있습니다. 이제 credits_used입니다. 여기서는 0인데, 검사가 무료라는 뜻은 아닙니다. 이 계정은 지난 24시간 안에 이미 이 주소를 검사했기 때문에 반복 검사에는 비용이 청구되지 않았습니다. 이와 같은 첫 검사는 크레딧 1개입니다. verification_mode는 답이 어디서 왔는지 알려 줍니다. 이번에는 캐시된 기록에서 왔습니다. 결과를 이해하는 데 쓰세요. 청구는 credits_used를 읽으세요.

4. 01:23최대 50개 주소

   짧은 목록이라면 /verify/bulk를 쓰세요. 헤더는 그대로이고, 본문에는 emails 배열을 담습니다. 주소는 최대 50개입니다. 결과는 같은 응답에 돌아옵니다. 각 주소에는 방금 본 것과 같은 필드가 붙습니다. 첫 번째는 catch-all입니다. 두 번째는 무효입니다. 그 메일함이 존재하지 않기 때문입니다. 세 번째는 일회용입니다. 세 개 모두 크레딧을 썼습니다. 무효도 포함됩니다. 여기서 일회용이 청구된 것은 이 요청에서 check_smtp를 true로 설정했기 때문입니다. 이를 빼면 일회용으로 일치하는 순간 일찍 멈추고 비용이 없습니다. 그래서 기본값에서는 알 수 없음, 구문 오류, 일회용은 무료입니다. 나머지는 모두 크레딧 1개이며, catch-all과 역할도 포함됩니다. 결과 아래에는 합계가 나옵니다. valid_emails가 0인 것은 catch-all을 유효로 세지 않기 때문입니다. 그리고 buckets가 배치를 묶어 줍니다. catch-all을 포함해 쓸 수 있는 것이 하나, 전달 불가가 둘입니다. 50개를 넘게 보내면 HTTP 400과 코드 3103이 나옵니다. 목록이 자동으로 쪼개지지 않고, 파일 작업으로 바뀌지도 않습니다. 오류는 파일 엔드포인트를 알려 줍니다.

5. 02:28더 큰 목록

   더 큰 목록은 파일을 올리세요. 비동기이므로 업로드하면 작업 ID를 받습니다. 그 ID로 진행 상황을 확인하세요. 작업이 끝나면 결과를 내려받습니다. -L 플래그는 그대로 두세요. 다운로드가 리디렉션될 수 있기 때문입니다. 다운로드는 CSV입니다. 원래 열은 그대로 남고 ev_status, ev_reason 같은 새 열이 뒤따릅니다.

6. 02:49크레딧 확인

   /credits로 남은 크레딧을 확인합니다. GET이며 같은 헤더를 씁니다. 큰 업로드 전에 확인하세요. 크레딧이 부족하면 API가 402를 반환하기 때문입니다.

7. 03:00요청 옵션 두 가지

   검사 동작을 바꾸는 옵션이 두 가지 있습니다. SMTP는 기본으로 켜져 있으며, 이메일은 절대 발송되지 않습니다. check_smtp를 false로 하면 메일 서버를 건너뛰므로 대부분의 주소가 알 수 없음으로 돌아옵니다. force_refresh를 true로 하면 캐시를 건너뛰고, 새 결과에 대해 비용을 냅니다.

8. 03:17오류와 제한

   먼저 처리할 오류는 세 가지입니다. 401은 키가 없거나 유효하지 않다는 뜻입니다. 402는 크레딧이 부족하다는 뜻입니다. 429는 속도 제한이니 잠시 물러났다가 다시 시도하세요. 속도 제한은 API 키마다 적용됩니다. single은 분당 6,000건입니다. bulk는 1,500건.

9. 03:37다음 단계

   파일 업로드는 300건입니다. 퀵스타트는 여기까지입니다. single, bulk, 파일, 크레딧. 전체 API 레퍼런스와 SDK, 웹훅은 billionverify.com/docs에 있습니다. 계정을 사용하는 날은 매일 무료 크레딧 20개를 받고, 월 최대 600개까지 쓸 수 있습니다. 신용카드는 필요 없습니다. billionverify.com에서 시작하세요.

이 영상에 나온 도구