開発ドキュメント - SMSMobileAPI
SMSmobileAPI 開発者ドキュメント WhatsApp メッセージは当社の API を通じてのみ送信できます。 詳細はこちらをクリック.

SMSmobileAPI では、あらゆるアーキテクチャやプラットフォームと API を可能な限り互換性のあるものにするよう努めています。
REST、SOAP、cURL、または Python、JavaScript、PHP などのさまざまなプログラミング言語を使用している場合でも、当社の API はプロジェクトにシームレスに統合できるように設計されています。

また、eコマース ソリューションやソフトウェア用のすぐに使用できるプラグインもご用意しています。 クリックしてご覧ください.

ご質問、ご提案、またはサポートが必要な場合は、当社のチームがお手伝いいたします。
お気軽にお問い合わせください api@smsmobileapi.com

.
API レスト
cURL
JavaScript JavaScript
パイソン パイソン
Node.js Node.js
ルビー ルビー
WSDL

SMSとWhatsApp APIの送信

SMSMobile API は、シンプルな API キーを使用するか、クライアント ID とクライアント シークレットを使用した OAuth2 プロトコルを使用する 2 つの認証方法をサポートしています。

1. SMS送信のためのAPIキー認証

このメソッドには、GET または POST リクエストのいずれかにパラメータとして含めることができる API キーが必要です。これは、API リクエストを認証する簡単な方法です。

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=PHONE_NUMBER&message=MESSAGE_TO_SEND

パラメータ:

- apikey: 固有の API キー。
- recipients: 受信者の電話番号。
- message: 送信するメッセージ(メッセージの長さは160文字に制限されません。より長いメッセージを送信できます)
- sendwa: 1 = メッセージは WhatsApp 経由で送信する必要があります。
- sendsms: 1 = メッセージは従来のSMSで送信する必要があります。( SMSを送信 空: デフォルトで送信されます。SMS をブロックするには 0 に設定します)
- schedule_timestamp = SMS を送信する時刻を表します - **UNIX タイムスタンプ (GMT 0)** である必要があります

例:

https://api.smsmobileapi.com/sendsms?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld を取得します。
注: オペレータが原因で配信エラーが発生した場合、デフォルトの機能により、定義された間隔内で同じ SMS の送信が最大 3 回再試行されます。

2. SMS送信のためのOAuth2認証

OAuth2 は、より安全でスケーラブルな認証方法を提供します。
アクセストークンを取得するにはクライアントIDとクライアントシークレットを使用する必要があります。アクセストークンは、 承認 ヘッダ。

client_id と client_secret はダッシュボードで利用でき、アプリをインストールしてモバイル デバイスにアカウントを作成するとアクセスできるようになります。
今すぐモバイルアプリをダウンロード または ダッシュボードにアクセスします。

アクセストークンの取得

アクセス トークンを取得するには、クライアント ID とクライアント シークレットを使用してトークン エンドポイントに POST リクエストを送信します。

curl -X POST https://api.smsmobileapi.com/oauth2/token \
-H "Content-Type: application/x-www-form-urlencoded" \
-d "grant_type=client_credentials" \
-d "client_id=1ab0ex4b4c1ef2c800690d" \
-d "client_secret=3ed108a93d0414074b94364290b6a7348475e93a0567005"

アクセストークンの使用:

アクセストークンを取得したら、それを 承認 API リクエストのヘッダー:

curl -X POST https://api.smsmobileapi.com/sendsms \
-H "認証: ベアラー abc123xyz456" \
-H "コンテンツタイプ: application/x-www-form-urlencoded" \
-d "受信者=+1234567890" \
-d "メッセージ=こんにちは"

どの方法を使用すべきでしょうか?

- 使用 APIキー認証 迅速かつ簡単な統合を実現します。

- 使用 OAuth2認証 統合におけるセキュリティとスケーラビリティを強化します。

詳細については、完全なドキュメントを参照してください。


送信されていないSMSを再送信する

この API エンドポイントは、未送信の SMS を再送信するために使用されます (メッセージがエラー状態の場合のみ)

https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY

パラメータ:

- guid: (必須) 再送信するメッセージの GUID。


APIから送信されたSMSのログ

この API エンドポイントは、API 経由で送信された SMS メッセージのログを取得するために使用されます。

https://api.smsmobileapi.com/log/sent/sms?apikey=YOUR_API_KEY

パラメータ:

- apikey: (必須) API キー。
- guid_message: 並べ替えやフィルタリングに使用されるメッセージの一意の識別子で短縮されます。
- before: この特定のタイムスタンプまたは GUID より前に送信されたメッセージを取得します。
- error_api: API リクエスト中にエラーが発生したすべての SMS を一覧表示するには、「1」(「&error_api=1」) を入力します。
- error_mobile: モバイル処理中にエラーが発生したすべての SMS を一覧表示するには、「1」(「&error_mobile=1」) と入力します。
- keyword: 受信者の番号または SMS コンテンツに基づいてメッセージをフィルターするためのキーワード。



モバイルAPIで受信したSMSを取得する

この API エンドポイントは、スマートフォンで受信した SMS メッセージを取得するために使用されます。

https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY

パラメータ:

- apikey: あなたが持っている、または受け取る予定の API キー。
.


Webhook – SMS 受信

この Webhook システムは、SMS を受信するたびに、設定された URL に POST リクエストを送信します。システムは、指定された Webhook URL に SMS の詳細を配信することで、リアルタイムの更新を保証します。

ダッシュボードでWebhookを設定する方法

ダッシュボードで Webhook URL を設定するには、次の手順に従います。

  1. アカウントにログインしてください SMS モバイル API ダッシュボード.
  2. に移動 Webhook設定 セクション。
  3. Webhook URLを入力します(例: https://example.com/webhook-endpoint
  4. クリックして Webhook を保存 ボタン。
  5. 保存すると、システムは設定された URL に SMS の詳細を送信し始めます。

Webhook ペイロード

SMS を受信すると、システムは次の JSON ペイロードを Webhook URL に送信します。

{
「日付」: 「2025-01-20」、
"時間": "10:15:00",
"受信時間": "2025-01-20 10:14:50",
"message": "こんにちは、これはテストです。",
"番号": "+123456789",
"guid": "abcde12345"
}

ペイロードフィールド:

  • 日付: SMS が追加された日付 (YYYY-MM-DD)。
  • 時間: SMS が追加された時間 (HH:mm:ss)。
  • 受信時間: SMS を受信した時刻。
  • メッセージ: SMSの内容。
  • 番号: 送信者の電話番号。
  • ガイド: SMS の一意の識別子。

Webhookエンドポイントの例

サーバーは、受信した POST リクエストを処理できる状態になっている必要があります。以下は、Webhook ペイロードを処理する PHP スクリプトの例です。

<?php
// 受信ペイロードを読み取ります
$ペイロード = file_get_contents('php://input');
$データ = json_decode($ペイロード、true);


// SMSデータを処理する
($データ)の場合{
// 例: SMS データをファイルに記録する
file_put_contents('sms_log.txt', print_r($data, true), FILE_APPEND);


// HTTP 200 ステータスで応答する
レスポンスコード200
echo "Webhook を正常に受信しました。";
} それ以外 {
// 不正なリクエストに対しては HTTP 400 ステータスで応答します
レスポンスコード400

echo "無効なペイロードです。";
}
?>

Webhookのテスト

Webhook 構成をテストするには、次のようなツールを使用します。

これらのツールを使用すると、システムから送信されたペイロードを検査し、Webhook 設定に関する問題をデバッグできます。

トラブルシューティング

  • Webhook URL が正しく、公開アクセス可能であることを確認します。
  • 成功したリクエストに対してサーバーが HTTP 200 ステータス コードを返すことを確認します。
  • ペイロードの処理中にエラーが発生していないか、サーバー ログを確認してください。

SMS API を削除する

このAPIエンドポイントは、SMSモバイルAPIのサーバーログからSMSメッセージを削除するために使用されます。

https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY

パラメータ:

- apikey: あなたが持っている API キー。
- guid_message: 削除するメッセージの一意の ID。
- date_start: 単独で使用すると、指定された日付のすべてのメッセージが削除されます。
- date_start and date_end: 指定された期間内のメッセージを削除するために組み合わせます。

注: 削除される SMS は、モバイル アプリ アカウントのログに保存されているものだけです。モバイル デバイス自体の SMS は、弊社ではアクセスできないため削除されません。

携帯電話にインストールされている Android のバージョンによっては、SmsMobileApi アプリケーションがフォアグラウンドにない場合、オペレーティング システムによって SMS メッセージの自動送受信が適切に機能しない場合があります。
この問題は、アプリケーションがアクティブに起動されていないときにバックグラウンドで実行しようとするプロセスから発生します。ただし、Android のバッテリー最適化対策はバージョンによって異なるため、このバックグラウンド プロセスが正しく開始されない可能性があります。Android のバッテリー最適化は、バッテリー寿命を節約するためにアプリのバックグラウンド アクティビティを制限するように設計されているため、バックグラウンド プロセスが正常に機能する必要があるアプリに意図せず影響を与える可能性があります。

この問題に対処するには、ユーザーは Android 設定を手動で構成して、SmsMobileApi が制限なくリソースを使用できるようにすることができます。
これには、特定のアプリのバッテリー最適化設定の調整が含まれ、基本的には、SmsMobileApi がバックグラウンドで実行され、必要に応じてリソースを使用することを許可するように Android に指示します。これにより、アプリケーションは、フォアグラウンドでアクティブなアプリケーションでない場合でも、SMS メッセージを自動的に送受信できるようになります。この調整により、必要なバックグラウンド プロセスが中断されることなく動作できるようになり、適切な実行を妨げる可能性のあるバッテリー最適化機能を回避できます。


開発者向けFAQ

アコーディオン サンプルの説明API キーを生成するには、当社のアプリケーションを携帯電話にダウンロードし、無料でアカウントを作成してください。API キーは自動的に生成され、携帯電話にリンクされます。また、必要なすべての情報が記載された電子メールも送信されます。このプロセスにより、最小限の設定で当社のサービスを迅速かつ簡単に使い始めることができます。
モバイル アプリケーションで、[設定] または [ヘルプ] メニューに移動すると、API キーが常に表示されます。これにより、統合やサービスの使用に必要なときにいつでも API キーに簡単にアクセスできます。
はい、API キーを作成するために身元の証明は必要ありません。したがって、当社の API とお客様の携帯電話間の通信は 100% 匿名です。このアプローチにより、ユーザーは当社のサービスを利用しながらプライバシーを維持できます。

今すぐ SMSmobileAPI を使い始めましょう!

外出先で SMS サービスを管理する自由と柔軟性を体験してください。今すぐモバイル アプリをダウンロードして、シームレスな SMS 統合への第一歩を踏み出しましょう。

アプリをダウンロード
モバイルを接続する