技術詳細

Identity Insight API は、電話番号に関連する通信事業者、加入者、デバイスに関連する幅広い属性にアクセスするための単一の API を提供する。開発者は単一のエンドポイントを活用して、通常複数のサプライヤ、CSP、統合方法を必要とする様々な属性を取得できる。

属性は「インサイト」にグループ化され、それぞれが特定の機能セットに対応しています。入手方法は地域によって異なる場合があります。開発者は、1回のリクエストで取得するインサイトを指定するだけです。

事前登録なしで利用できるインサイトもあれば、携帯電話会社の承認が必要なインサイトもある。承認が必要なインサイトを下表に示す。これらのインサイトへのアクセスは、「ネットワークレジストリ」を通じて管理されます。アクセスを要求する方法については、以下に従ってください。本ガイド.

洞察	説明	承認は必要か？	カバレッジ	ステータス
フォーマット	電話番号のフォーマットの検証と、そこから派生する情報の検索。	いいえ	ワールドワイド	一般的な利用可能性
オリジナル・キャリア	最初に割り当てられたネットワークに関する情報。Numbersingプランのプレフィックスに基づく情報。	いいえ	ワールドワイド	一般的な利用可能性
現在のキャリア	番号が現在割り当てられているネットワークに関する情報。	いいえ	ワールドワイド	一般的な利用可能性
SIMスワップ	モバイルアカウントに関連する最近のSIMペアリング変更に関する情報。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	一般的な利用可能性
ロケーション検証	エンドユーザーの位置が指定されたエリア内にあるかどうかをVerifyする。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
加入者マッチ	電話番号のエンドユーザーデータを、ネットワークオペレータに登録されているデータと比較する。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	ベータ
ローミング	デバイスがローミングしているかどうか、ローミングしている場合はどの国でローミングしているかなど、デバイスのローミング状況に関する情報を取得する。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
到達可能性	データやSMSの可用性を含む、デバイスの接続状況に関する情報を取得する。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
デバイススワップ	携帯電話にペアリングされたSIMの最近のデバイス変更に関する情報。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
番号のリサイクル	指定された日付以降、その電話番号に関連付けられているユーザーに変更があったかどうかを確認してください。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
加入期間	指定された電話番号の利用期間が、顧客から指定された日付よりも長いかどうかを確認します。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー
年齢確認	指定された年齢基準に基づき、照会された電話番号に登録されている加入者の年齢を確認します。	登録方法ネットワーク・レジストリ	参照ネットワークの特徴	開発者プレビュー

テスト

を使用する。ネットワーク・レジストリ、API呼び出しによって、許可された少数のテスト番号に対してのみ実際のデータが返される、安全で管理されたテスト環境を利用することで、Identity Insights APIをすぐに使い始めることができます。本番環境とは異なり、オペレーターによる承認は必要ありません。

にもアクセスできます。バーチャル・オペレーター仮想Numbersのために、偽の、しかし決定論的な応答を生成するシミュレートされたオペレータ。

APIリファレンス

Identity Insights API の OpenAPI 仕様は以下のとおり。これ.

地域別エンドポイント

Identity Insights API には、API リクエストの送信先を定義する複数のエンドポイントがあります：

エンドポイント	地域
`https://api-eu.vonage.com/identity-insights/v1/requests`	EU
`https://api-us.vonage.com/identity-insights/v1/requests`	US

はじめに

チェックアウトはじめに Identity Insights API を使用する方法については、ステップバイステップのガイドを参照してください。