ローミング

Vonage Identity Insights APIのRoaming Insightを使用して、モバイルネットワーク上の指定したデバイスのローミングステータスと国を確認する。デバイスがローミングしている国を、最後にブロードキャストされた時刻のタイムスタンプとともに特定できます。

この情報が役に立つ使用例としては、以下のようなものがある：

不正の識別： ユーザーに新たな摩擦を与えることなく、詐欺リスクを低減する。例えば、口座名義人のローミングステータスと一致しない国から多額の取引が要求されたとする。銀行が特定した国とローミングによって検出された国との不一致により、銀行は取引をブロックする。
規制遵守： 特定の国におけるビデオストリーミングのコンテンツライセンス制限など、ユーザーのセルラーネットワークのロケーションに基づく規制遵守や地域制限を実施する。
サービスのパーソナライゼーション： ユーザーの位置に応じて、サービスや広告をシームレスにパーソナライズする。

前提条件

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

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

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

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

APIを呼び出す

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

この例では、指定したデバイスがローミングしているかどうか、そしてローミングしている場合、そのデバイスがどの国でローミングしているかを確認するために、Roamingインサイトに対する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": "+990123411",
    "purpose": "FraudPreventionAndDetection",
    "insights": {
      "roaming": {}
        }
    }'

APIは次に、そのデバイスのローミング情報を返します。もしそのデバイスがローミング中で、ローミングしている国を特定できれば、その国は country_codes フィールドにいる：

{
  "request_id": "c2cc7a65-9b10-493f-9c0a-1c86751a91c4",
  "insights": {
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z",
        "is_roaming": true,
        "country_codes": ["DE"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
  }
}

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

フィールド	説明
`latest_status_at`	関連するローミングステータスが最後に更新された時刻。
`is_roaming`	ローミング状況 `true` ローミングの場合
`country_codes`	その国（または複数の国）の2文字の国コード。 `phone_number` でローミングしている。配列には通常1つの要素が含まれるが、ローミングネットワークが複数の国に関連しているエッジケースでは、追加の国コードが含まれる。これは ISO 3166-1 alpha-2 という形式をとっている。
`status`	指定された電話番号について返された情報のステータスを示す。
`code`	リクエストのステータスを示すコード。のいずれかでなければならない： `NO_COVERAGE`:国またはモバイルネットワークは、利用可能なサプライヤーによってサポートされていません。 `INVALID_PURPOSE`:使用された目的は、このインサイトで有効または許可されていません。 `UNAUTHORIZED`:アプリケーション、サプライヤー、電話番号の組み合わせでは、リクエストを承認できませんでした。 `INTERNAL_ERROR`:リクエストの処理中に内部エラーが発生しました。 `SUPPLIER_ERROR`:サプライヤーがリクエスト処理中にエラーを返しました。 `NOT_FOUND`:このインサイトの電話番号が見つかりません。 `INVALID_NUMBER_FORMAT`:電話番号フォーマットは、キャリアからユーザーへの割り当てには無効です。 `OK`:インサイトは正常に処理されました。
`message`	より詳細なステータスの説明。

さらに読む

Identity Insights API の詳細については、以下を参照してください。 APIリファレンス.
ご不明な点がございましたら、下記までお問い合わせください。 VonageコミュニティSlack.