關於本影片

本影片中的回應都是真實的 API 回應，已做縮短。API 金鑰、批次驗證和文件驗證需要付費帳號。

影片文字稿

1. 00:00你的第一個請求

   你的第一個請求是向 /verify/single 發送 POST。送出一個 JSON 欄位 email，把你的 API 金鑰放在 BV-API-KEY 標頭裡。整個請求就這些。把這個金鑰存放在伺服器的環境變數裡，絕不要放在用戶端程式碼中。建立金鑰需要付費帳號，任意一次積分購買即可解鎖。

2. 00:24讀懂回應

   這是一個客服地址的真實回應。先看 status。它顯示 role，因為 support 是共用郵箱的名稱，不是某個人。score 是零點六。這是按固定規則得出的值，不是機率，所以要根據 status 來分支，而不是根據分數。is_deliverable 為 true，說明郵件伺服器接受了這個地址。is_catch_all 也為 true，說明這個域名接受任何地址。role 佔據了 status，其餘情況仍由各個標記顯示。reason 以一個代碼給出原因，這裡是 catch-all deliverable。

3. 01:02為什麼 credits_used 是 0

   文件裡有一頁列出了所有代碼。再看 credits_used。這裡是零，但這並不表示檢查是免費的。這個帳號在過去 24 小時內已經檢查過這個地址，所以重複檢查沒有收費。像這樣的首次檢查消耗一個積分。verification_mode 說明答案來自哪裡，這一次來自快取的歷史記錄。用它來理解結果，計費則看 credits_used。

4. 01:23最多 50 個地址

   名單很短？用 /verify/bulk。標頭不變，請求內容接受一個 emails 陣列，最多 50 個地址。結果就在這同一個回應裡返回。每個地址都帶有你剛才見過的那些欄位。第一個是 Catch-all。第二個是無效，因為那個郵箱不存在。第三個是一次性。三個都消耗了一個積分。無效也算。這裡一次性也算，是因為這個請求把 check_smtp 設為 true。省略它，一次性比對會提前停止，不收費。所以預設情況下，未知、語法錯誤和一次性不收費。其餘的都是一個積分，包括 Catch-all 和角色。結果下面是彙總。valid emails 是零，因為 Catch-all 不算有效。分組把這一批歸類：一個可用但為 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 和 Webhook 都在 billionverify.com/docs。每天使用帳號即可獲得 20 個免費積分，每月最多 600 個，無需信用卡。造訪 billionverify.com 開始使用。

本影片中展示的工具