Identity Insights APIがベータ版に

ご注意 Identity Insights APIは一般公開を終了しました！詳細は リリースをご覧ください。

新しい アイデンティティ・インサイトAPIがベータ版としてリリースされました！このリリースは、開発者が電話番号インテリジェンスに関連するエキサイティングなモバイルネットワークの機能を利用できるようにするための大きな前進です。

Identity Insights API とは？

Identity Insights APIは、各電話番号の背後にあるキャリア、デバイス、加入者に関するリアルタイムのインテリジェンスにより、ブランドが摩擦のない、安全で、パーソナライズされたカスタマージャーニーを作成できるようにします。

Diagram showing how the Identity Insights API connects phone data from operators and regulatory authorities to customer journeys for fraud prevention and personalization

• 単一のAPIコールで、利用可能な属性セット（インサイト）の任意の組み合わせを要求する。

• 電話番号の所有者にとって、押しつけがましくなく、摩擦がなく、透明であるように設計されています。

• 単一のエンドポイントから新機能をシームレスに拡張。

• 相互接続、統合方法、コンプライアンスの複雑さを管理する必要なく、世界中の何百もの事業者や規制当局に瞬時にリーチを拡大します。相互接続や統合方法、コンプライアンスの複雑さを管理する必要はありません。

利用可能なインサイトの全リストは 技術文書.

アイデンティティ・インサイトでできること

Identity Insights は、ニーズに応じてさらに多くのサポートを提供できるが、ここでは一般的な使用例をいくつか紹介する：

本人確認と詐欺対策の強化

詐欺師は SIMスワップフィッシングや偽の ID を使用してセキュリティを回避します。Identity Insights APIは、最近のSIMスワップや疑わしい番号の種類など、詐欺のシグナルをリアルタイムで検出するのに役立ちます。

信頼できるコミュニケーションのための電話番号の検証

すべての番号が同じではありません。有効なフォーマット、割り当てられた携帯キャリア、目的に合った番号かどうかを即座にチェックします（例：音声、SMSで顧客に連絡するかどうか、 RCSまたはアプリ通知で顧客に到達するかどうかなど）を瞬時にチェックし、コンプライアンス上の問題を回避し、メッセージングコストを削減し、サインアップ時のデータ品質を向上させます。

エンゲージメントの最適化と顧客データの充実

リアルタイムの電話インテリジェンス（時間帯、キャリア、回線タイプなど）を使用して、アウトリーチを調整し、エンゲージメントを高め、ユーザーのセグメンテーションやパーソナライゼーションなど、よりスマートな意思決定を行います。

Identity Insights API の仕組み

Identity Insights APIにリクエストすると、世界中の何百もの携帯電話会社や規制当局からデータを取得する最適な場所を特定し、リアルタイムで情報を返します。

異なる地域間の多様な標準、統合、規制要件に対処する複雑さを抽象化する。

必要な情報は何か、それをどのように解釈すれば十分な情報に基づいた意思決定ができるのか、ということだけに集中すればよい。

たとえば、このリクエストは Format と SIM Swap のインサイトを返します：

curl -X POST https://api-eu.vonage.com/v0.1/identity-insights \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
   "phone_number": "447009000000",
   "purpose": "FraudPreventionAndDetection",  
   "insights": {
      "format": {},
      "sim_swap": {
         "period": 240
      }
    }
  }'

レスポンスには、両方のインサイトリクエストの結果が含まれる：

{
   "request_id": "aaaaaaaa-bbbb-cccc-dddd-0123456789ab",
   "insights": {
      "format": {
         "country_code_iso2": "GB",
         "country_code_iso3": "GBR",
         "country_name": "United Kingdom",
         "country_prefix": "44",
         "offline_location": "United Kingdom",
         "time_zones": [
                "Europe/Guernsey",
                "Europe/Isle_of_Man",
                "Europe/Jersey",
                "Europe/London"
            ],
         "number_international": "447920000000",
         "number_national": "07920 000000",
         "format_valid": true,
         "status": {
            "code": "OK",
            "message": "Success"
         }
      },
      "sim_swap": {
         "latest_sim_swap_at": "2024-07-08T09:30:27.504Z",
         "swapped": true,
         "status": {
            "code": "OK",
            "message": "Success"
         }
      }
   }
}

試してみる

始めるのは簡単だ：

1. 当社の 開発者ポータル

2. アカウントを作成する/ 既存の認証情報を使用する

3. 環境を設定し、新しいアプリケーションを作成する

4. 最初のAPIコールを行う

   1. ダッシュボードの使用

   2. cURLの使用

をご覧ください。 API仕様書.

次はどうする？

今後数ヶ月間、私たちは

• 拡大 地理的カバレッジ.

• 加入者照合、位置確認、ローミング状況、到達可能状況などの新しいインサイトを追加。

• 重複するレガシーAPIの廃止 ナンバーインサイトv2および スタンドアロンSIMスワップ.

Identity Insights API を使い始めることに興奮していますか？ご参加ください Vonage コミュニティ Slackに参加し、この新しい API の開発にご協力ください！ご参加いただけるのは #ネットワーク-apisチャンネルに参加し、チームから直接最新情報を入手してください。また、ナンバーインサイトやシムスワップAPIからの移行についてご質問やご不明な点がございましたら、ご連絡ください。