この動画について

この動画のレスポンスは、実際の API レスポンスを短くしたものです。API キー、一括検証、ファイル検証には有料アカウントが必要です。

動画の文字起こし

1. 00:00最初のリクエスト

   最初のリクエストは、/verify/single への POST です。JSON のフィールドを 1 つ、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 は理由を 1 つのコードで示します。ここでは 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 件のアドレスです。結果は、同じレスポンスで返ってきます。各アドレスには、いま見たのと同じフィールドが付きます。1 つ目は catch-all です。2 つ目は無効です。そのメールボックスが存在しないからです。3 つ目は使い捨てです。3 件とも 1 クレジットを使いました。無効もカウントされます。使い捨てがここで課金されるのは、このリクエストで check_smtp を true にしたからです。それを省くと、使い捨てに一致した時点で早期に止まり、課金されません。つまりデフォルトでは、不明、構文エラー、使い捨ては無料です。それ以外はすべて 1 クレジットで、Catch-all と役割も含みます。結果の下には、合計が表示されます。valid_emails が 0 なのは、catch-all は有効として数えられないからです。そして buckets がバッチを分類します。catch-all を含めて使えるものが 1 件、配信不可が 2 件です。50 件を超えて送ると、HTTP 400 とコード 3103 が返ります。リストは自動で分割されず、ファイルジョブにもなりません。エラーは、ファイルのエンドポイントを案内します。

5. 02:28もっと大きなリスト

   もっと大きなリストは、ファイルをアップロードします。非同期なので、アップロードするとジョブ ID が返ります。その ID で進捗を確認します。ジョブが完了したら、結果をダウンロードします。-L フラグは付けたままにしてください。ダウンロードがリダイレクトされることがあるからです。ダウンロードされるのは CSV です。元の列はそのまま残り、ev_status や ev_reason のような新しい列が続きます。

6. 02:49クレジットを確認する

   /credits で残りを確認できます。GET で、同じヘッダーを使います。大きなアップロードの前に確認してください。クレジットが足りないと、API は 402 を返します。

7. 03:002 つのリクエストオプション

   チェックの動作を変えるオプションが 2 つあります。SMTP はデフォルトでオンで、メールが送られることは一切ありません。check_smtp を false にすると、メールサーバーへの問い合わせを省くので、ほとんどのアドレスは不明で返ります。force_refresh を true にすると、キャッシュを使わず、新しい結果に対して課金されます。

8. 03:17エラーとレート制限

   最初に処理するエラーは 3 つです。401 は、キーがない、または無効です。402 は、クレジット不足です。429 はレート制限なので、待ってから再試行してください。レート制限は API キーごとに適用されます。single は 1 分あたり 6,000 リクエスト。bulk は 1,500。

9. 03:37次のステップ

   ファイルのアップロードは 300 です。以上がクイックスタートです。single、bulk、ファイル、クレジット。完全な API リファレンス、SDK、Webhook は billionverify.com/docs にあります。アカウントを使う日は毎日 20 クレジットが無料で、月最大 600 クレジットまで利用できます。クレジットカードは不要です。billionverify.com から始めましょう。

この動画で紹介したツール