Nexmo CLI を介した Number Insight の使用

概要

Nexmo CLIを使用すると、curl を使用してリクエストを作成したり、プログラムコードを記述したりすることなく、Number Insight API を操作できます。このガイドでは、その方法を説明します。

最初のステップ

始める前に：

Nexmo アカウントへのサインアップ - これにより、Number Insight API にアクセスするために必要な API キーとシークレットが付与されます。
Node.JSのインストール - npm (ノードパッケージマネージャー) を使用して Nexmo CLI をインストールします。

Nexmo CLI のインストールとセットアップ (コマンドラインインターフェース)

ターミナルプロンプトで次のコマンドを実行して、Nexmo CLI をインストールします。

npm install -g nexmo-cli

注：十分なシステム権限がない場合は、上記のコマンドの前に sudo を付ける必要があります。

次に、Nexmo CLI に VONAGE_API_KEY と VONAGE_API_SECRET を提供します。これらは、Dashboard の最初のステップページにあります。

nexmo setup VONAGE_API_KEY VONAGE_API_SECRET

この操作は、Nexmo CLI を初めて使用する場合にのみ行う必要があります。

Basic API で自分の番号を試す

Number Insight Basic API は無料で使用できます。nexmo insight:basic (または nexmo ib) を使用し、表示されている番号を自分の番号に置き換えて、自分の番号でテストします。番号は、国際形式でなければなりません。

nexmo insight:basic 447700900000

Nexmo CLI には、入力した番号とその番号の国が表示されます。

447700900000 | GB

Number Insight API からの応答に含まれるその他の詳細を表示するには、--verbose スイッチ (または、略して -v) を使用します。

nexmo insight:basic --verbose 447700900000

Basic API からの完全な応答には、次の情報が含まれています。

この人間に読める形式の出力は、JSON 応答で使用可能なフィールド名とデータを反映しており、リクエストに関するデータ (status、status_message、request_id)、番号が属する国の詳細 (country_name、country_prefix など) およびその国に合わせて番号を適切にフォーマットする方法 (national_format_number) を返します。

上記のような応答が表示されない場合は、API の認証情報をチェックし、Node.js と nexmo-cli が正しくインストールされていることを確認してください。

Standard API および Advanced API をテストする

Standard および Advanced Number Insight APIは、オペレーターの詳細やローミングステータス (携帯電話番号の場合) など、番号に関するさらに多くの情報を提供します。各 API レベルに含まれる応答データについては、機能の比較表を参照してください。

注：Standard API および Advanced API への呼び出しは無料ではなく、利用時にアカウントに請求するかどうかを確認するよう求められます。

Number Insight Standard API の使用

Number Insight Standard API を使用するには、nexmo insight:standard コマンドを使用します

nexmo insight:standard --verbose 447700900000

標準 API からの一般的な応答は、次のようになります。

Number Insight Advanced API の使用

Advanced API を使用するには、insight:advanced (または ia) を使用します。

nexmo insight:advanced --verbose 447700900000

応答で次の追加フィールドを探します。

[lookup_outcome] フィールドと [lookup_outcome_message] フィールドは、Advanced API が番号の有効性 ([valid_number])、リーチャビリティ ([reachable])、ローミングステータス ([roaming.status]) を判断できたかどうかを示します。