APIの技術的な詳細をVerifyする

はじめに

Verify APIは、Vonageが提供する次世代の二要素認証(2FA)ソリューションです。SMS、音声、Eメールに加え、WhatsAppやRCSといったOTT(Over-The-Top)チャネルなど、より幅広いチャネルに対応することで、従来の認証方法をさらに拡充しています。

Verifyは、より深い統合とより大きなカスタマイズを可能にするイベントコールバックとサマリーコールバックを導入しています。例えば

  • どのチャンネルがコンバージョンに成功し、どのチャンネルが成功しなかったかについての詳細な洞察を提供するサマリーコールバックを受信するようにWebhookを構成することができます。
  • イベントコールバックはWhatsAppコードレスフローのような高度なユーザーエクスペリエンスを可能にします。この場合、エンドユーザーは認証のためにWhatsAppメッセージ内のボタンをタップするだけで、イベントコールバックがバックエンドにトリガーされ、認証フローが継続されます。

認証

Verify では、API 要求を安全に認証する必要があります。Verify API リクエストを認証する方法については、以下を参照してください。 認証ガイド.

ワークフロー

ワークフローは、エンドユーザーに OTP を配信するために使用されるチャネルの順序を定義します。順序、タイムアウト設定、およびフォールバック動作をカスタマイズして、検証エクスペリエンスを最適化できます。

で詳細な情報と例をご覧ください。 ワークフローガイド.

APIはどのように機能するのか?

以下は、サマリーコールバックを持つVerifyリクエストフローの視覚的表現である:

Verify V2 Request with Summary Callbacks

初期設定とステップバイステップの紹介については、以下を参照してください。 スタートガイド.

対応言語

Verify API は、多くの言語をサポートしています。 locale パラメータを使用する。 APIリファレンス).その ロケールの検証 ガイドには、サポートされている locale.

報告

Reports API は、Vonage 製品全体にわたる利用状況やレポートデータを取得するための中核となる手段であり、開発者や企業が、通話記録や電話番号を含むアクティビティ、課金、取引の詳細を一貫した方法で追跡できるようにします。複数の Vonage API から取得した利用状況や課金データを、1 つの統一された形式にまとめることで、レポート作成を簡素化します。 Reports API は、以下のような幅広いユースケースで利用できます。

  • 顧客への請求 - すべてのサブアカウントに関連するトランザクションをダウンロードし、含まれている価格データを使用して顧客への請求額を決定します。
  • 請求書の照合 - 利用データと受け取った請求書を比較します。
  • モニタリングと分析 - リアルタイムのCDRデータをビジネスインテリジェンスや分析システムに追加し、他のイベントと関連付けます。
  • デバッグ - 最大13ヶ月分の詳細な使用データを調査することで、問題のトラブルシューティングを行います。

参照 レポート API ドキュメント ガイド、コードスニペット、ベストプラクティス、料金など、詳細についてはこちらをご覧ください。

次はどうする?

Verify APIの技術的な基礎を理解したところで、構築を開始する準備が整った!

  • に従う。 スタートガイド を参照して、最初の検証ワークフローをステップ・バイ・ステップで実装してください。

  • 探検する APIリファレンス エンドポイント、パラメータ、および高度なオプションの完全なリストについては、こちらをご覧ください。