){kind=small}
PHPでNumber Insight APIを使用する方法
所要時間：2 分
この記事の最終更新日：2026年1月 ジュリア・ビロ
この投稿では、Vonage Number Insight APIを使ってあらゆる電話番号を検証し、その情報を得るために私が最近作ったアプリケーションの例を紹介する。私のプロジェクトを出発点として使うこともできます（コードは GitHubにあります）、あるいはここにある例を自分のアプリケーションで使えるようにアレンジすることもできます。Numbers Insight APIは、電話番号が有効で、最新のもので、特定の地域にあることを確認するのに理想的なので、契約時に連絡先の詳細を確認するためによく使われます。
To complete this tutorial, you will need a Vonage API account. If you don’t have one already, you can sign up today and start building with free credit. Once you have an account, you can find your API Key and API Secret at the top of the Vonage API Dashboard.
この例では、Composer経由でインストールしたPHPといくつかの依存関係を使用しています。
コードは GitHubリポジトリ- クローンするか、開発マシンにダウンロードしてください。
Number Insights APIは、指定された電話番号に関する情報を提供し、さまざまなサービスレベルとそれに対応する価格レベルで利用できる。
ベーシックレベルは無料で、番号が存在し、有効であることをチェックするのに非常に便利です。このようなツールを使用することは、ユーザーが有効な連絡先情報を提供することを期待する場合、本当にそうであるかどうかをチェックすることができるので、素晴らしい練習になります。
スタンダード・レベルでは、ベーシック・レベルに加え、番号の種類や使用キャリアに関する情報が提供される。アドバンスレベルでは、上記のすべてに加え、ローミングと到達可能性情報が含まれます。
Advanced Number Insight APIは、非同期呼び出しとしても利用できる。この例は 開発者ポータル.
良い 機能比較表があります。
まず、プロジェクト・コードを置いたディレクトリに移動する。使用する Composerを使って依存関係をインストールします：
コピー config.php.sampleを config.phpにコピーし、編集してVonage APIキーとシークレットを追加します。 ダッシュボード).
最後に public/ディレクトリに移動し、ウェブサーバーを起動する：
ブラウザで http://localhost:8080/ にアクセスすると、興味のある番号とどの程度の洞察力を求めるかを入力するフォームが表示される。
Screenshot of number insights form
プロジェクトの依存関係の一つは vonage/clientこのライブラリーを使用すると、どのPHPアプリケーションからでもAPIを簡単に使用できます。今日はSlimPHPを使っていますが、このPHPライブラリーはどんなフレームワークや他のプロジェクトでも使えます。
プロジェクトの構造を見てみましょう。 public/index.php.トップレベルのルートは、ユーザーがフォームを見ることができるように、ページテンプレート(を見るには templates/main.phpを見てください)。フォームは /insightに送信され、このルートでほとんどの処理が行われます。
$params = $request->getParsedBody();
$basic = new \Vonage\Client\Credentials\Basic(
$config['api_key'],
$config['api_secret']
);
$client = new \Vonage\Client($basic);
// choose the correct insight type
switch($params['insight']) {
case "standard":
$insight = $client->insights()->standard($params['number']);
break;
case "advanced":
$insight = $client->insights()->advanced($params['number']);
break;
default:
$insight = $client->insights()->basic($params['number']);
break;
}
まず、フォームのパラメータを $params(に取り込み（このヘルパー関数が唯一のSlim特有の部分です！）、次に \Vonage\Clientオブジェクトをインスタンス化し、API キーとシークレットを渡します。
次に、正しいNumber Insights APIエンドポイントが呼び出されるようにswitchステートメントがあり、デフォルトのタイプとして "basic "が指定されている！なぜなら、ユーザーの入力は決して信用できないからだ！これはフォームであり、彼らは私たちに何でも送ることができる。
レスポンスは $insightに保存され、アクションはそれを表示のためにテンプレートに渡します。レスポンスの $insight値はオブジェクトですが、データフィールドは配列記法でアクセスできます。 $insight['status']もしくは $insight['country_code'.テンプレートでは、フィールドは表形式のレイアウトで表示され、以下に示すように、このレベルのNumber Insightで返されたフィールドが表示されます：
Screenshot of the number insights output
エラー結果の処理もあります。 statusステータスコードとメッセージがテンプレートに渡され、フォームの上に表示されます。無効な電話番号を入力してテストすることができます。
次に行きたい場所をいくつか紹介しよう：
APIリファレンス APIリファレンスを参照するのがよいだろう！
コード・スニペットは、他のプログラミング言語でも開発者ポータルで利用可能です。
単発の番号検索には CLI から Number Insights API を使用する。.
試す アイデンティティインサイトAPI電話番号に関連するキャリア、加入者、デバイスに関する幅広い属性にリアルタイムでアクセスできます。
