이 영상 소개

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

영상 스크립트

1. 00:00파일 업로드

   CSV를 /verify/file에 업로드한 다음, 끝나면 웹훅으로 알림을 받습니다. Bulk는 주소 50개까지입니다. 그보다 큰 것은 파일 전체를 multipart 폼 데이터로 보내세요. CSV, TXT, XLSX를 받습니다. email_column으로 읽을 열을 지정합니다. 생략하면 자동으로 감지합니다. 이것이 테스트 파일입니다. 네 행과, 결과에 그대로 남기고 싶은 source 열이 있습니다. 업로드는 확인이 끝나기를 기다리지 않습니다. 작업 ID와 pending 상태로 응답합니다. 어떤 열을 읽었는지, 행과 고유 주소가 몇 개인지도 알려 줍니다. API 키와 마찬가지로 파일 작업은 유료 계정용입니다.

2. 00:43작업 추적하기

   확인하려면 같은 경로에 작업 ID를 붙여 GET합니다. 헤더는 같고 본문은 없습니다. 바로 물어보니 이 작은 파일은 이미 merging 중이었습니다. 실행되는 동안 상태는 preparing, pending, processing, merging 같은 단계를 거칩니다. completed, completed with warning, failed, cancelled 중 하나가 보이면 그만 물어보세요. 이것이 끝난 작업입니다. 개수는 상태별로 파일을 나눕니다. 무효 하나, 역할 하나, Catch-all 하나, 일회용 하나. credits_used는 1이고 cache_hit_not_charged는 3입니다. 세 행은 재확인이었습니다. 그 주소는 최근 24시간 안에 이 계정에서 확인되었고, 24시간 안의 재확인에는 차감되지 않습니다. 링크가 두 개 따라옵니다. download_url은 안정적인 API 경로이므로 저장할 것은 이쪽입니다. direct_download_url은 서명된 스토리지 링크이며, 표시된 만료 시각이 지나면 작동하지 않습니다.

3. 01:35결과 가져오기

   results를 호출하고 출력을 파일로 저장하세요. 필터가 없으면 API는 전체 결과 파일로 리다이렉트하며, curl의 -L이 그 리다이렉트를 따라갑니다. 여러분의 열이 변경 없이 맨 앞에 옵니다. 그다음에 ev_ 열이 모든 행에 이어집니다. status, score, reason 같은 것들입니다. 제거할 행만 필요한가요? 필터를 추가하세요. 필터는 OR로 결합되므로 이것은 무효 또는 일회용을 요청합니다. 필터를 쓰면 CSV가 만들어져 바로 돌아옵니다. 두 행이 돌아옵니다. 제거할 행입니다.

4. 02:04웹훅 사용하기

   폴링도 되지만 오래 걸리는 작업이면 요청이 많아집니다. 웹훅은 방향을 뒤집습니다. 파일 작업이 끝나거나 실패하면 BillionVerify가 여러분의 서버를 호출합니다. /webhooks에 POST해서 등록하세요. HTTPS URL과 받고 싶은 이벤트를 지정합니다. 이벤트는 두 가지, file.completed와 file.failed입니다. 그 응답에는 서명용 시크릿이 들어 있으며, 볼 수 있는 것은 이때뿐입니다. 바로 저장하세요. 모든 전달을 확인하는 데 필요합니다. 각 전달은 JSON POST이고 헤더는 세 개입니다. 이벤트, 타임스탬프, 서명입니다. 본문에는 이벤트와 시각이 있습니다. data에는 작업 ID, 개수, 사용한 크레딧, 다운로드 링크가 들어 있습니다.

5. 02:44서명 확인하기

   전달에 따라 동작하기 전에 서명을 확인하세요. 타임스탬프 헤더, 점, 원본 본문을 이어 붙입니다. 시크릿으로 HMAC-SHA256을 계산하고 서명 헤더와 비교하세요. 본문은 도착한 그대로 해시하세요. 파싱했다가 다시 인코딩한 JSON은 일치하지 않습니다. 또 오래된 타임스탬프는 거부해서 지난 요청이 재전송되지 않게 하세요. 그러니 전체 흐름은 짧습니다. 업로드하고, 작업 ID를 저장하고, 웹훅을 기다리고, 안정적인 링크에서 결과를 가져옵니다.

6. 03:11다음 단계

   상태 값, 필터, 모든 웹훅 필드는 billionverify.com/docs/api-reference의 API 레퍼런스에 있습니다. 계정을 사용하는 날은 매일 무료 크레딧 20개를 받고, 월 최대 600개까지 쓸 수 있습니다. 신용카드는 필요 없습니다. billionverify.com에서 시작하세요.