オリジナル・キャリア

オリジナル・キャリア洞察は、Vonage独自のNumbersing Planインテリジェンスを使用して、電話番号に元々関連付けられていたキャリアとネットワーク・タイプに関する低遅延情報を提供します。これは、サードパーティのサプライヤやオペレータへのライブクエリを必要とせずにメタデータを提供し、多くのユースケースで高速かつ信頼性の高いものにしています。

この洞察は、その後の変更ではなく、最初の割り当てに焦点を当てているため、ポータビリティの変更を反映していませんが、電話番号の性質を特定する上で非常に価値があります。これは、番号が最初に携帯電話、固定電話、フリーダイヤル、プレミアムレート、またはバーチャルとして指定されたかを示すことができ、これらは詐欺防止、コスト管理、およびユーザー資格に関連することが多いカテゴリです。

主な利点は以下の通り：

  • 詐欺リスクのシグナル なりすましや人為的なトラフィックの増加を示す可能性のある、バーチャル、プレミアム、またはリスクの高い番号タイプを見抜く。
  • コスト効率： プロセスの初期段階で、高価な番号や無効な番号と関わることは避ける。
  • データの質： 番号の発信元を把握することで、リードや顧客記録を事前にスクリーニング。

オリジナル・キャリアは、通信の合理化、人工的に膨張させたトラフィックの削減、軽量インテリジェンスによるNumbersベースのワークフローの最適化を目指すビジネスに最適です。

前提条件

Identity Insights を使用するには、アカウントが正しく設定されていることを確認する必要があります。 はじめに のガイドを参照されたい：

  • アカウントの作成
  • Identity Insights API で使用する Vonage アプリケーションの作成、
  • 利用可能なさまざまな環境と、それらを使用するためのアカウントの設定方法、
  • また、Dashboard Getting Started UIを使用して、コードを書かずにAPIを使用する方法も紹介します。

このガイドでは、cURLを使用してプログラムでOriginal Carrier Insightを使用する方法を説明します。

Identity Insights API は、複数の地域のエンドポイントから利用できる。本ガイドの例では EU エンドポイントを使用していますが、全リストは以下を参照してください。 技術詳細.

APIを呼び出す

Identity Insights API の認証は、コンパクトで自己完結型の JSON トークンである JWT を介して行われます。JWT を生成するには、当社の オンラインジェネレーターあるいは Vonage CLI.JWTを生成するには、アプリケーションIDと秘密鍵が必要です。JWTを取得したら、APIにリクエストを送信できます。

この例は、Original Carrierインサイトに対するcURLリクエストを示している：

curl -X POST https://api-eu.vonage.com/identity-insights/v1/requests  \
  -H "Authorization: Bearer $JWT" \
  -H "Content-Type: application/json" \
  -d '{
    "phone_number": "14040000000",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "original_carrier": {}
        }
    }'

APIは、電話番号がもともと割り当てられていたネットワークに関する情報（名前、ネットワークタイプ、国コードなど）を返す：

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "original_carrier": {
        "name": "Orange Espana, S.A. Unipersonal",
        "network_type": "MOBILE",
        "country_code": "ES",
        "network_code": "21403",
        "status": {
        "code": "OK",
        "message": "Success"
        }
    }
  }
}

以下のフィールドが original_carrier 配列である：

フィールド 説明
name に関連する元のキャリアのフルネーム。 phone_number 提供されます。これは携帯電話番号にのみ適用されます。
network_type ネットワークの種類 phone_number が関連している。のいずれかになる：

MOBILE:通常、音声通話やテキストメッセージ（SMS）の送受信が可能な携帯端末に割り当てられる番号。
LANDLINE:主に音声通話に使用され、通常SMSメッセージは受信できない。
TOLLFREE:Numbers(ナンバーズ) : 通話料を請求されることなく、企業やサービスに電話をかけることができる番号。
PREMIUM:投票回線や情報ホットラインなど、特殊なコンテンツやサービスに使用されることが多い。
VIRTUAL:特定のSIMカードやデバイスに縛られないクラウドベースの番号で、アプリやオンラインプラットフォーム（Google Voiceなど）で管理されることが多い。
country_code の2文字の国コード phone_number.これは ISO 3166-1 alpha-2 という形式をとっている。
network_code モバイル国コード（MCC） + モバイルネットワークコード（MNC）。 E.212 国際移動加入者ID.
status 指定された電話番号について返された情報のステータスを示す。
code リクエストのステータスを示すコード。のいずれかでなければならない：

NO_COVERAGE:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。
INVALID_PURPOSE:使用された目的は、このインサイトで有効または許可されていません。
UNAUTHORIZED:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。
INTERNAL_ERROR:リクエストの処理中に内部エラーが発生しました。
SUPPLIER_ERROR:サプライヤーがリクエスト処理中にエラーを返しました。
NOT_FOUND:このインサイトの電話番号が見つかりません。
INVALID_NUMBER_FORMAT:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。
OK:インサイトは正常に処理されました。
message より詳細なステータスの説明。

さらに読む