アイデンティティ・インサイトのためのバーチャル・オペレーター

仮想オペレータは、定義済みの確定的な API レスポンスを提供します。 ネットワーク・レジストリ 未割り当ての国番号に関連する電話番号を使用する場合 +990.これは、実際のオペレータにアクセスできないシナリオで、ネットワーク機能の発見、開発、テストのためのシミュレートされたオペレータとして使用できます。

バーチャルオペレーターを使用するには、Applicationsで「ネットワーク機能」を有効にし、「アクセステスト」タイプを選択してください。電話番号宛てのすべてのAPI呼び出しにおいて、 +990 プレフィックスが自動的にバーチャルオペレーターにリダイレクトされます。

仮想オペレータを使用して行われるすべてのAPIコールは、通常の携帯電話オペレータを使用して行われるものと同じ認証フローを実装する必要があります。

バーチャルオペレーターは、Vonageネットワーク機能の設定が行われているあらゆるApplicationsで、デフォルトで利用可能です。 ネットワーク・レジストリ. バーチャルオペレーターを使用するために、これ以上の設定は必要ありません。

+990の番号を許可リストに追加する必要はありません。サポートされているVonageネットワーク機能のいずれかに対してAPI呼び出しを行うだけで結構です。

回答

バーチャルオペレーターでテストできる電話番号は10個あります: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488そして +990123499.

これらの電話番号を使用したリクエストに対する応答は、使用しているインサイトによって異なります。

SIMスワップ

これらの電話番号のどれを使っても同じ返事が返ってくる: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488

{
    "latest_sim_swap_at": "2017-11-14T01:07:28Z", // 500 hours ago
    "is_swapped": false, // true if period < 500 hours, false if period > 500 hours
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号の使用 +990123499 は不明な電話番号の応答を返します:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "Unknown phone number."
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

加入者マッチ

マッチしたレスポンスは、提供された電話番号に従って返される。リクエストは、サポートされている属性を1つ以上含むことができる。次の例では、ユーザは given_name, family_nameそして birthdate:

電話番号 +990123400

{
    "given_name_match": "DATA_UNAVAILABLE",
    "family_name_match": "DATA_UNAVAILABLE",
    "birthdate_match": "DATA_UNAVAILABLE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123411 または +990123477

{
    "given_name_match": "EXACT",
    "family_name_match": "EXACT",
    "birthdate_match": "EXACT",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123422

{
    "given_name_match": "HIGH",
    "family_name_match": "HIGH",
    "birthdate_match": "NONE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123433

{
    "given_name_match": "PARTIAL",
    "family_name_match": "PARTIAL",
    "birthdate_match": "NONE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123444

{
    "given_name_match": "LOW",
    "family_name_match": "LOW",
    "birthdate_match": "NONE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123455, +990123466 または +990123488

{
    "given_name_match": "NONE",
    "family_name_match": "NONE",
    "birthdate_match": "NONE",
    "status": {
        "code": "OK",
        "message": "Success."
    }
}

電話番号 +990123499

{
    "status": {
        "code": "NOT_FOUND",
        "message": "Unknown phone number."
    }
}

その他 +990 ナンバー

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

ロケーション検証

回答は、提供された電話番号によって決定されます。他のすべてのフィールドには、任意の値を設定できます。各検証結果が何を意味するかについての説明は API仕様:

電話番号 +990123400

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123411

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "PARTIAL",
    "match_rate": 50,
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123422

{
    "is_verified": "UNKNOWN",
    "status": {
        "code": "OK",
        "message": "The insight was processed successfully."
      }
}

電話番号 +990123433

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123444

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123455

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123466

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123477

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "FALSE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123488

{
    "latest_location_at": "2023-09-07T10:40:52Z",
    "is_verified": "TRUE",
    "status": {
    "code": "OK",
    "message": "Success"
    }
}

電話番号 +990123499

{
    "status": {
    "code": "NOT_FOUND",
    "message": "Unknown phone number."
    }
}

その他 +990 ナンバー

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

フォーマット

これらの電話番号のどれを使っても同じ返事が返ってくる: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488, +990123499

{
    "country_code": "XX",
    "country_name": "Virtual",
    "country_prefix": "990",
    "offline_location": "Virtual",
    "time_zones": ["UTC"],
    "number_international": "+990123411",
    "number_national": "123411",
    "is_valid_format": true,
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

オリジナル・キャリア

これらの電話番号のどれを使っても同じ返事が返ってくる: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488, +990123499

{
      "name": "Virtual CSP",
      "network_type": "MOBILE",
      "country_code": "XX",
      "network_code": "00101",
      "status": {
            "code": "OK",
            "message": "Success"
      }
}

その他 +990 の数値はエラーを返す:

{
      "status": {
            "code": "INVALID_NUMBER_FORMAT",
            "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
      }
}

現在のキャリア

これらの電話番号のどれを使っても同じ返事が返ってくる: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488, +990123499

{
      "name": "Virtual CSP",
      "network_type": "MOBILE",
      "country_code": "XX",
      "network_code": "00101",
      "status": {
            "code": "OK",
            "message": "Success"
      }
}

その他 +990 の数値はエラーを返す:

{
      "status": {
            "code": "INVALID_NUMBER_FORMAT",
            "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
      }
}

到達可能性

回答は、提供された電話番号によって決定されます。他のすべてのフィールドには、任意の値を設定できます。各検証結果が何を意味するかについての説明は API仕様.

すべての回答において、 latest_status_at は現在時刻から2分を引いた時刻を返す。

電話番号 +990123400, +990123444 そして +990123488 すべてのリターンはデータとSMSで接続されている:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
    "is_reachable": true,
    "connectivity": ["DATA","SMS"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

電話番号 +990123411 または +990123455 どちらもデータ付きで戻ってくる:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
    "is_reachable": true,
    "connectivity": ["DATA"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

電話番号 +990123422 または +990123466 どちらもSMSで返される:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
    "is_reachable": true,
    "connectivity": ["SMS"],
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

電話番号 +990123433 または +990123477 どちらも到達不能を返す:

{
"reachability": {
    "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
    "is_reachable": false,
    "status": {
            "code": "OK",
            "message": "Success"
         }
    }
}

電話番号 +990123499 電話番号が見つかりません:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight"
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

ローミング

回答は、提供された電話番号によって決定されます。他のすべてのフィールドには、任意の値を設定できます。各検証結果が何を意味するかについての説明は API仕様.

すべての回答において、 latest_status_at は現在時刻から2分を引いた時刻を返す。

電話番号 +990123400 収益 is_roaming が真なら、国コード "GB":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "country_codes": ["GB"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123411 収益 is_roaming が真なら、国コード "DE":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "country_codes": ["DE"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123422 収益 is_roaming が真なら、国コード "US":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "country_codes": ["US"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123433 収益 is_roaming が真で、複数の国コードがある:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "country_codes": ["BL,GF,GP,MF,MQ"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123444 収益 is_roaming が真なら、国コード "BR":

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "country_codes": ["BR"], 
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123455 収益 is_roaming は正しいが、国番号はない:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123466 収益 is_roaming は正しいが、国コードは特定できなかった:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": true,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123477 そして +990123488 両者とも is_roaming を偽とする:

{
    "roaming": {
        "latest_status_at":"2024-02-20T10:41:38.657Z", // 120 seconds ago
        "is_roaming": false,
        "status": {
            "code": "OK",
            "message": "Success"
        }
    }
}

電話番号 +990123499 電話番号が見つかりません:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight"
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

デバイススワップ

これらの電話番号のどれを使っても同じ返事が返ってくる: +990123400, +990123411, +990123422, +990123433, +990123444, +990123455, +990123466, +990123477, +990123488

{
    "latest_device_swap_at": "2017-11-14T01:07:28Z", // 500 hours ago
    "is_swapped": true, // false if period < 500 hours, true if period >= 500 hours
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号の使用 +990123499 は不明な電話番号の応答を返します:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight."
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

加入期間

以下に示すように、異なる仮想電話番号を使用すると、異なる応答が返されます。

電話番号 +990123400, +990123411, +990123422

{
"is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "PREPAID",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123433, +990123444, +990123455

{    
    "is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "POSTPAID",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号: +990123466, +990123477

{    
    "is_tenure_met": true, // false if date is >180 days ago
    "contract_type": "BUSINESS",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123488

{    
    "is_tenure_met": true, // or false based on L3
    "status": {
        "code": "SUCCESS",
        "message": "Unable to retrieve data for some fields"
    }
}

電話番号の使用 +990123499 は不明な電話番号の応答を返します:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight."
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

年齢確認

この点に関しては、使用した電話番号によって回答が異なります。

電話番号 +990123400, +990123411

{    
    "is_age_threshold_met": "TRUE", // age=12
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123422, +990123433

{    
    "is_age_threshold_met": "TRUE", // age=23
    "content_lock": "FALSE",
    "parental_control": "FALSE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123444、+990123455

{    
    "is_age_threshold_met": "TRUE", // age=37
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123466

{    
    "is_age_threshold_met": "TRUE", // age=15
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号 +990123477

{
    "is_age_threshold_met": "DATA_UNAVAILABLE",
    "status": { 
        "code": "OK", 
        "message": "Success" 
    } 
}

電話番号 +990123488

{    
    "is_age_threshold_met": "TRUE", // age=20
    "content_lock": "TRUE",
    "parental_control": "TRUE",
    "status": {
        "code": "OK",
        "message": "Success"
    }
}

電話番号の使用 +990123499 は不明な電話番号の応答を返します:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight."
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}

番号のリサイクル

仮想通信事業者からの応答は、指定された電話番号によって異なります:

電話番号 +990123400, +990123411, +990123422

{
	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 1 day
      "status": {
          "code": "OK",
          "message": "Success"
      }
}

電話番号 +990123433, +990123444, +990123455

{    
  	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 7 days
     "status": {
          "code": "OK",
          "message": "Success"
      }
}

電話番号: +990123466

{    
     "is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 30 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

電話番号: +990123477

{    
"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 90 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

電話番号: +990123488

{    
  	"is_number_recycled": true, // LAST_RECYCLED_DATE=TODAY - 180 days
     "status": {
         "code": "OK",
         "message": "Success"
      }
}

電話番号の使用 +990123499 は不明な電話番号の応答を返します:

{
    "status": {
        "code": "NOT_FOUND",
        "message": "The phone number could not be found for this Insight."
    }
}

その他 +990 の数値はエラーを返す:

{
    "status": {
        "code": "INVALID_NUMBER_FORMAT",
        "message": "Invalid number. Only the following Virtual Operator numbers are allowed: 990123400, 990123411, 990123422, 990123433, 990123444, 990123455, 990123466, 990123477, 990123488, 990123499."
    }
}