SMSの送信ステータスを確認しよう

SMS送信をチェックするコマンド

SMSメッセージの_送信ステータスの確認_にも、送信に使ったみたいに、やっぱりCURLを使いま〜す。 違うのは、つけるパラメーターと、URLだけですよ！

SMSの送信ステータスを確認するには、これを実行してみてね！

curl -u th3ApISiDt3xtTh4tyoUcoPied:Th3aUthT0k3nth4tY0uCopi3D \
https://api.xoxzo.com/sms/messages/tHi5i5y0urMsGIdt3xT/

ちゃんと送信できていたら、JSONレスポンスが返されるはず。こんな感じ。

HTTP/1.1 200 OK
Content-Type: application/json

{
    "status": "DELIVERED",
    "sent_time":"2015-08-27 09:22:32",
    "cost": 10,
    "sender": "your_number",
    "recipient": "your_recipientnumber",
    "url": "https://api.xoxzo.com/sms/messages/tHi5i5y0urMsGIdt3xT/",
    "msgid": "tHi5i5y0urMsGIdt3xT"
}

もちろん、costの部分は、送信したメッセージの数によるわね。 Xoxzo APIサービスのSMS送信料金を見て、確認してね！

送信したメッセージのステータスは、DELIVERED（配信成功）ばかりじゃないわよ。 下のリストにまとめてみたから、参考にしてね。

msgidを加えずに、確認したら?

こんな感じで実行しちゃうと、

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

過去90日間にあなたが送ったSMSゼンブのステータスを表示しま〜す！

スクリーンがいっぱいに！ 日付ごとのステータスって確認できる？

もっちろん！日付をパラメーターに含めたら、その日付のSMS送信ステータスを見れるわよ！ 日付のフォーマットは、year-month-day つまり 西暦年-月-日 でお願いね。実行するには、こういう風になりま〜す。

curl -u th3ApISiDt3xtTh4tyoUcoPied:Th3aUthT0k3nth4tY0uCopi3D \
https://api.xoxzo.com/sms/messages/?sent_date=2017-10-31

もし、その日付にSMS送信がなかったら、200 OK レスポンス が返されるけど、中身は空っぽのはずよ。

HTTP/1.0 200 OK
Content-Type: application/json

[]

送信ステータスの確認ができるのは、過去90日まで。それ以外の日付を設定しちゃうと、こういうレスポンスが返りま〜す。

HTTP/1.0 400 Bad Request
Content-Type: application/json

{
    "sent_date": [
        "Invalid sent_date"
    ]
}

パラメーターが間違っているときも、400 Bad Request レスポンスが返りますよ〜。

お疲れさま、今回のチュートリアルは、ここまで！ XoxzoのSMS送信ドキュメンテーションで、もっと詳しいところを確認してね！

ほかにも、Xoxzoでできる、すごいこと、たくさんあるから、その他のドキュメンテーションも、読んでみてね。質問があったら、連絡してね。

ではまた次回！

ミコちゃんのチュートリアル・シリーズ好評不定期連載中

Mikoシリーズ： - 最初のAPIユーザーを作ろう - はじめてのSMSを送ってみよう！ - SMSの送信ステータスを確認しよう - 音声案内を発信しましょう！ - テキスト読み上げ機能を使って、電話で認証してみましょう!

他のXoxzo tutorials: - ダイアルインナンバーを使ってみよう - SMSを使った二要素認証のやり方 - 音声電話を使った二要素認証のやり方 - かけるほうは通話料無料のフリーダイヤルは、0120だけじゃない！！ - 「自分専用」のボイスメールを設定してみる - Xoxzo APIのユーザーエクスペリエンス（第1回） - Xoxzo APIのユーザーエクスペリエンス（第2回） - SMS文面の字数制限について

SMSメッセージを送信するためのさらに簡単なオプションをお探しですか？ PCから顧客にSMSメッセージを送信方法を探しですか？ そして、コーディングせずにすぐに送信始めたいですか？smsアプリの代わりにパソコンからショートメール送信プログラムの おすすめはXoxzoの他のサービスEZSMSはどうでしょう？ 利用した分のみのお支払いからsms の送信、受信 料金心配せず！、月額費用も初期費用もかかりません。 ・プログラムをインストールしたりすることなく簡単にPCからSMSを送信できます。 ・顧客ごとにカスタマイズされたメッセージを送信できます。 無料登録後、即時にご利用のウェブブラウザーから、SMS(ショートメール)の配信機能をご利用いただいたり、ダイヤル・イン・ナンバーをご利用いただくことができます。 - 170カ国以上への送信も対応しています。 - 複数の宛先への一斉送信や、メッセージをカスタマイズして大量配信可能なCSVファイルを使った配信にも対応しています。 - いつでも、どこでもSMS送信が可能です。 すべてオンラインで完結できます - ダイヤルSMSでビジネスもイベントも大成功に導きましょう！