Xoxzo APIのユーザーエクスペリエンス（第1回）

今日、Xoxzo APIを使ってSMSを送信し、テキスト読み上げや電話会議などの電話をかけ、テレフォニーユーティリティ機能のひとつ、キャリア検索を試してみました。 まずはじめに、私は試用 に Xoxzo アカウントに登録し、そこへお試し用、おまけ50クレジットが付与されました。

私は最初のAPIユーザーを作成し、 以下のコマンドで使用する「API SID」と「認証トークン」を取得しました。

次にラップトップにCURL をダウンロードしました。 私はWindows OSを搭載したIntelプロセッサを使用しているので、 ノートパソコンの仕様と互換性のある、特定の実行可能ファイルを選択しました。 次に、CURL実行ファイルとライブラリファイルを格納するディレクトリ（フォルダ）にて、 Windowsコマンドプロンプトからすべてのコマンドを実行しました。

コマンドプロンプトに慣れている人は、ナビゲートには、CDコマンドが必要なだけです。 それ以外はCURL関数です。コマンドプロンプトを使用したことのない方は、ユーザーマニュアルをチェックし、 コマンドプロンプトの使い方を小一時間ほど、勉強するといいかと思います。 実際には、CD（ディレクトリの変更）にはほんの少しコマンドを使って練習するだけで十分です。

私は 音声通話API - オーディオファイル再生API から始めることにしました。 私はハープシコードの音楽を再生するMP3オーディオファイルを見つけました。 それを指すURLが、APIを実行するための前提条件です。 私は、Xoxzo チュートリアルのコマンドを 、私の環境に合わせて調整しました。私のコマンドは、こんな感じです。スクリーンショットも続いて御覧ください。

curl -u <API SID>:<Auth Token> --data-urlencode "caller=+60xxxxxxx" --data-urlencode "recipient=+81yyyyyyyy" --data-urlencode "recording_url=http://www.hubharp.com/web_sound/WalloonLilliShort.mp3" https://api.xoxzo.com/voice/simple/playbacks/

コマンドプロンプトにCallIDが表示されました。その後、私の電話が鳴り始めました。電話に出ると、ハープシコードの音楽が流れました。

音声コールの成功直後に、コマンドプロンプトに表示されたCallIDを指定し、コールステータスチェックAPIにてコールステータスをチェックしました。こちらが私のコマンドと、スクリーンショットです。

curl -u <API SID>:<Auth Token> https://api.xoxzo.com/voice/calls/41c181b6-1817-4f91-8a4f-5e0cf5105092/

私は自分のアカウントをチェックし、16クレジットが差し引かれ、34クレジットが残っているのを確認しました。こちらが、スクリーンショットです。

テキスト読み上げ機能機能や電話会議APIなどの、他のVoice APIをテストするのに必要なクレジットが足りなくなってしまいました。40クレジットが、最低でも必要です。私は、テキスト読み上げ機能を使い、音声通話を試みたとき、失敗をしました。

curl -u : https://api.xoxzo.com/sms/messages/

ですから、次に、SMSの送信 を試したのです。こちらが、私の使ったコマンドで、続いてコマンドプロンプトのスクリーンショットです：

curl -u <API SID>:<Auth Token> --data-urlencode "sender=XoxzoBlog" --data-urlencode "recipient=+81yyyyyyyy" --data-urlencode "message=これは初めてのSMSです。Xoxzoから送っています。" https://api.xoxzo.com/sms/messages/

コマンドの後、メッセージIDが表示されました。その後、私は SMSのステータスを確認するため、このコマンドを実行しました。

一方、SMS通知着信音が、私の携帯電話から聞こえました。私はウェブから送信されたSMSを受信したのです：

50クレジットもかけず、私は、テレフォニーユーティリティAPI - キャリア検索API を試してみることができました。私は日本の携帯電話番号とマレーシアの携帯電話番号を使ってこの機能を試しました。 私が実行したコマンドとスクリーンショット：

curl -u <API SID>:<Auth Token>  --data-urlencode "recipient=+81yyyyyyyy" https://api.xoxzo.com/utilities/carrierlookup/

私が入力した日本の電話番号は、MVNOのAsahi Netから購読しました。MVNOは表示されず、実際のキャリア（この場合はNTT Docomo）が表示されました。私が入力したマレーシアの番号は、別のキャリア（Celcom）に変更したものでした。今回、変更前のキャリアであったMaxisが表示されました。私はナンバーポータビリティ（Mobile Number Portability）がベストエフォートベースでサポートされており、エンドキャリアに依存していることを認識しており、私の場合は反映されていないということです。

固定電話の番号を入力すると、返されるパラメータはすべて「null」でした。この機能は、携帯電話番号のみを対象としています。この機能は、使用されているかどうかにかかわらず、携帯電話番号の有効性をチェックするために使用できます。

どの国の携帯電話番号もサポートされています。電話帳からさまざまな大陸の携帯電話番号を試しましたが、すべてに結果が返されました。スクリーンショットは、簡潔さ、明確さ、機密性の目的で省略します。

(次回へ続く)