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

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

バーチャルオペレーターを使用するには、アプリケーション設定で「Playground」を選択します。APIコールはすべて +990 プレフィックスが自動的にバーチャルオペレーターにリダイレクトされます。

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

仮想オペレータは、ネットワーク機能用に設定されたすべてのアプリケーションでデフォルトで使用できます。遊び場モードを使用します。仮想オペレータを使用するために、これ以上の設定は必要ありません。

990番号を許可リストに追加する必要はありません。サポートされているネットワーク機能のいずれかに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."
    }
}

オリジナル・キャリア

{
      "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."
      }
}

現在のキャリア

{
      "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."
    }
}

ローミング

すべての回答において、 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."
    }
}