Numbersインサイト・ベーシック

2027年2月4日をもって、VonageはVonage Number Insightsを終了いたします。継続的なサポートを確保し、よりスケーラブルで将来性のあるソリューションを提供するため、当社の強化されたソリューションへの移行をお勧めします： Vonage Identity Insights API.Vonage Identity Insight APIは、複数の電話番号関連データセットを1つの柔軟なAPIに統合し、電話番号に関するリアルタイムの情報を要求したり、番号のフォーマット、キャリアの詳細、SIMスワップ、加入者照合などのインサイトを1回の呼び出しで自由に組み合わせて取得できるようにします。

をご確認ください。 Numbersインサイト移行ガイドAPIの相違点、必要な変更点、スムーズな移行のためのベストプラクティスに関する詳細なガイダンスを提供しています。

Vonage Number Insight Basic APIを使用して決定します：

  • ナンバーが登録されている国
  • そのNumbersの国内外での表現

これにより、ユーザーのロケールに合った正しい形式でNumbersを表示することができます。

コード例を実行する前に、変数のプレースホルダーを置き換えてください：

キー説明
VONAGE_API_KEY

Your Vonage API key (see it on your dashboard).

VONAGE_API_SECRET

Your Vonage API secret (also available on your dashboard).

INSIGHT_NUMBER

The number you want to retrieve insight information for.

コードを書く

ni-basic.sh に以下を追加する：

curl \
  -u "${VONAGE_API_KEY}:${VONAGE_API_SECRET}" \
  "https://api.nexmo.com/ni/basic/json?number=$INSIGHT_NUMBER"

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

sh ni-basic.sh

前提条件

npm install @vonage/server-sdk

ni-basic.js という名前のファイルを作成し、以下のコードを追加する：

const { Vonage } = require('@vonage/server-sdk');

const vonage = new Vonage({
  apiKey: VONAGE_API_KEY,
  apiSecret: VONAGE_API_SECRET,
});

全文を見る

コードを書く

ni-basic.js に以下を追加する：

vonage.numberInsights.basicLookup(INSIGHT_NUMBER)
  .then((result) => console.log(result))
  .catch((error) => console.error(error));

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

node ni-basic.js

前提条件

build.gradle に以下を追加する：

implementation 'com.vonage:server-sdk-kotlin:2.1.1'

BasicInsight という名前のファイルを作成し、main メソッドに以下のコードを追加する：

val client = Vonage {
    apiKey(VONAGE_API_KEY)
    apiSecret(VONAGE_API_SECRET)
}

全文を見る

コードを書く

BasicInsight ファイルのmain メソッドに以下を追加する：

val response = client.numberInsight.basic(INSIGHT_NUMBER)
println(response)

全文を見る

コードを実行する

Gradle用のアプリケーション プラグインを使うことで、アプリケーションの実行を簡単にすることができます。build.gradle を以下のように更新する：

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

以下のgradle コマンドを実行し、com.vonage.quickstart.kt.numberinsight をBasicInsight を含むパッケージに置き換えてアプリケーションを実行する：

gradle run -Pmain=com.vonage.quickstart.kt.numberinsight.BasicInsight

前提条件

build.gradle に以下を追加する：

implementation 'com.vonage:server-sdk:9.3.1'

BasicInsight という名前のファイルを作成し、main メソッドに以下のコードを追加する：

VonageClient client = VonageClient.builder()
        .apiKey(VONAGE_API_KEY)
        .apiSecret(VONAGE_API_SECRET)
        .build();

全文を見る

コードを書く

BasicInsight ファイルのmain メソッドに以下を追加する：

BasicInsightResponse response = client.getInsightClient().getBasicNumberInsight(INSIGHT_NUMBER);
System.out.println("International format: " + response.getInternationalFormatNumber());
System.out.println("National format: " + response.getNationalFormatNumber());
System.out.println("Country: " + response.getCountryName() +
        " (" + response.getCountryCodeIso3() + ", +" + response.getCountryPrefix() + ")"
);

全文を見る

コードを実行する

Gradle用のアプリケーション プラグインを使うことで、アプリケーションの実行を簡単にすることができます。build.gradle を以下のように更新する：

apply plugin: 'application'
mainClassName = project.hasProperty('main') ? project.getProperty('main') : ''

以下のgradle コマンドを実行し、com.vonage.quickstart.insight をBasicInsight を含むパッケージに置き換えてアプリケーションを実行する：

gradle run -Pmain=com.vonage.quickstart.insight.BasicInsight

前提条件

Install-Package Vonage

BasicInsights.cs という名前のファイルを作成し、以下のコードを追加する：

using Vonage;
using Vonage.NumberInsights;
using Vonage.Request;

全文を見る

BasicInsights.cs に以下を追加する：


var creds = Credentials.FromApiKeyAndSecret(VONAGE_API_KEY, VONAGE_API_SECRET);

全文を見る

コードを書く

BasicInsights.cs に以下を追加する：


var request = new BasicNumberInsightRequest() { Number = INSIGHT_NUMBER };

全文を見る

前提条件

composer require vonage/client

コードを書く

basic.php に以下を追加する：

$basic  = new \Vonage\Client\Credentials\Basic(VONAGE_API_KEY, VONAGE_API_SECRET);
$client = new \Vonage\Client($basic);

$insights = $client->insights()->basic(INSIGHT_NUMBER);

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

php basic.php

前提条件

pip install vonage python-dotenv

コードを書く

ni-basic.py に以下を追加する：

from vonage import Auth, Vonage
from vonage_number_insight import BasicInsightRequest, BasicInsightResponse

client = Vonage(Auth(api_key=VONAGE_API_KEY, api_secret=VONAGE_API_SECRET))

insight: BasicInsightResponse = client.number_insight.get_basic_info(
    BasicInsightRequest(number=INSIGHT_NUMBER)
)
pprint(insight)

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

python number-insight/ni-basic.py

前提条件

gem install vonage

ni-basic.rb という名前のファイルを作成し、以下のコードを追加する：

client = Vonage::Client.new(
  api_key: VONAGE_API_KEY,
  api_secret: VONAGE_API_SECRET
)

全文を見る

コードを書く

ni-basic.rb に以下を追加する：

insight = client.number_insight.basic(
  number: INSIGHT_NUMBER
)

puts insight.inspect

全文を見る

コードを実行する

このファイルをあなたのマシンに保存し、実行する：

ruby ni-basic.rb

APIからのレスポンスには以下のデータが含まれている：

{
    "status": 0,
    "status_message": "Success",
    "request_id": "fcb1e9a2-db9c-4ea2-84be-4e60da45e187",
    "international_format_number": "447700900000",
    "national_format_number": "07700 900000",
    "country_code": "GB",
    "country_code_iso3": "GBR",
    "country_name": "United Kingdom",
    "country_prefix": "44"
}

返される各フィールドの説明と、可能なすべての値については Numbers Insight API ドキュメント