SMSドキュメント

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

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

ヘルプが必要ですか? api@smsmobileapi.com

検索

SMSを送信

このエンドポイントを使用すると、携帯電話から SMS を送信できます。

終点：

得る役職 https://api.smsmobileapi.com/sendsms/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
recipients	必須受信者の電話番号。
message	必須送信するメッセージ (160 文字の制限なし)。
port	SMS の送信に使用する SIM ポートを定義します。 1, 2、または空のままにしておきます。空のままにすると、利用可能な SIM ポートを使用して SMS が自動的に送信されます。このパラメータはAndroidバージョン以降で利用可能です 4.1.15.0 アプリが前景.
shorturl	1 = URLを短縮リンクに変換する 0または空 = 変換なし
sIdentifiant	SMSを送信する接続済みの携帯電話を選択してください。最初の利用可能なデバイスは空欄のままにしてください。アプリ3.0.35.3以降が必要です。
sendwa	1 = WhatsApp 経由で送信します。
sendsms	1 = SMSで送信（空欄の場合はデフォルト）。SMSをブロックするには0に設定します。
encrypt_message	はい = 受信者は復号化するためのキーが必要です。もっと詳しく知る
schedule_timestamp	SMS を送信する UNIX タイムスタンプ (GMT 0)。

リクエスト例：

GET https://api.smsmobileapi.com/sendsms/?apikey=YOUR_API_KEY&recipients=+1234567890&message=HelloWorld

注意: オペレーターによる配信エラーが発生した場合、デフォルト機能は最大 3 回再試行します。

JSONレスポンスの例：

{ "result": { "error": 0, "sent": "1", "id": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "note": "sent by mobile", "datetime": "2026-03-20T21:07:44Z", "datetimeLocal": "2026-03-20T22:07:44+01:00", "port": null, "iac_control": "1", "iac_authorized": "1", "send_with_whatsapp": "0", "encrypted": { "status": "0" }, "trial_account": { "status": "0", "sms_sent": 0 } } }

回答の説明：

分野	説明
result.error	0 エラーなし。それ以外の値が返された場合は、リクエストが失敗したか、ブロックされたことを意味します。
result.sent	1 ＝メッセージが携帯電話から送信されることが承認されました。
result.id	APIによって生成される一意のメッセージ識別子。追跡やログ記録のために保存できます。
result.note	メッセージがどのように処理されたかに関する追加情報。例：モバイルから送信.
result.datetime	API応答のUTC日時。
result.datetimeLocal	モバイル端末またはサーバーの設定に基づいた現地日時。
result.port	SIMポートは送信に使用されます。 1, 2、またはヌル指定されていない場合、または返されない場合。
result.iac_control	内部API制御ステータス。 1 これは、リクエストが内部検証チェックを通過したことを意味します。
result.iac_authorized	1 これは、そのAPIキーがこのエンドポイントを使用する権限を持っていることを意味します。
result.send_with_whatsapp	1 ＝メッセージはWhatsApp経由で処理されます。 0 = 標準的なSMS送信。
result.encrypted.status	1 ＝暗号化が有効になっています。 0 ＝暗号化せずに送信されたメッセージ。
result.trial_account.status	1 = このアカウントは試用アカウントです。 0 = 通常のアカウント。
result.trial_account.sms_sent	該当する場合、トライアルアカウントから既に送信されたSMSの数。

成功した応答は通常、 エラー = 0 そして 送信済み = 1.

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

このエンドポイントを使用すると、送信されなかったSMSを再送信できますが、メッセージが現在エラー状態にある場合に限ります。

終点：

得る役職 https://api.smsmobileapi.com/resend/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
guid	必須再送信するメッセージのGUID。

リクエスト例：

https://api.smsmobileapi.com/resend/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE を取得します

JSONレスポンスの例：

{ "result": { "error": "0", "sms": "正常に再送信されました", "attempt": 1 } }

回答の説明：

分野	説明
result.error	0 エラーなし。再送信リクエストは正常に受け付けられました。
result.sms	APIから返されるステータスメッセージ。この例では、SMSが正常に再送信されたことが確認されています。
result.attempt	再送信試行回数を示します。

注：このエンドポイントは、エラー状態であり、再送信可能なメッセージに対してのみ機能します。

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

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

終点：

得る https://api.smsmobileapi.com/log/sent/sms/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
guid_message	固有のメッセージ識別子でフィルタリングします。
before	この値より前に送信されたメッセージを取得します。実装によっては、タイムスタンプまたはメッセージ参照のいずれかになります。
error_api	1 = APIリクエストエラーが発生したSMSメッセージのみを一覧表示します。
error_mobile	1 = モバイル処理エラーが発生したSMSメッセージのみを表示します。
keyword	受信者番号またはメッセージの内容でフィルタリングします。

リクエスト例：

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

JSONレスポンスの例：

{ "result": { "error": "0", "sms": [ { "sIdentifiantPhone": "abbg00055x5", "port": 0, "date_add": "2026-03-20", "hour_add": "22:07:44", "timestamp": 1774044464, "send_from_mobile": 1, "send_from_mobile_date": "2026-03-20", "send_from_mobile_heure": "22:10:05", "send_from_mobile_timestamp": 1774044605, "recipients": "32495898697", "sms": "test", "error_api": "", "send_from_mobile_erreur": "", "guid_message": "c319d3b35e8f8712cde20dae39ac3c19f86eda25", "timearea": "UTC+01", "date_add_server": "2026-03-20", "hour_add_server": "21:07:44", "timestamp_server": 1774040864, "send_from_mobile_date_server": "2026-03-20", "send_from_mobile_heure_server": "21:10:05" } ] } }

回答の説明：

分野	説明
result.error	0 エラーなし。リクエストは正常に処理されました。
result.sms	APIによって返された送信済みSMSログエントリを含む配列。
result.sms[].sIdentifiantPhone	送信に使用された電話機の識別情報（利用可能な場合）。
result.sms[].port	SMS送信に使用されるSIMポート。
result.sms[].date_add	SMSがキューに追加された現地日時。
result.sms[].hour_add	SMSがキューに追加された時点の現地時間。
result.sms[].timestamp	ローカルのキューに登録された日時を示すUNIXタイムスタンプ。
result.sms[].send_from_mobile	1 = SMSは携帯電話から送信されました。 0 ＝まだ送信されていないか、送信前に失敗した。
result.sms[].send_from_mobile_date	携帯電話が実際にSMSを送信した現地日時。
result.sms[].send_from_mobile_heure	携帯電話が実際にSMSを送信した現地時間。
result.sms[].send_from_mobile_timestamp	携帯電話からの実際の送信時刻を示すUNIXタイムスタンプ。
result.sms[].recipients	受取人の電話番号。
result.sms[].sms	メッセージの内容。
result.sms[].error_api	APIリクエスト処理中にエラーが発生した場合、そのエラーメッセージを表示します。空欄の場合は、APIエラーが発生しなかったことを意味します。
result.sms[].send_from_mobile_erreur	送信中にモバイル端末から返されたエラー（発生した場合）。空欄の場合は、モバイル端末にエラーがなかったことを意味します。
result.sms[].guid_message	固有のメッセージGUID。
result.sms[].timearea	現地の日付と時刻フィールドに使用されるタイムゾーン。
result.sms[].date_add_server	サーバー側でSMSが追加された日時。
result.sms[].hour_add_server	サーバー側でSMSが追加された時刻。
result.sms[].timestamp_server	サーバー側のUNIXタイムスタンプ（SMSが追加された時点）。
result.sms[].send_from_mobile_date_server	サーバー側で、携帯電話からSMSが送信された日時。
result.sms[].send_from_mobile_heure_server	サーバー側で、携帯電話からSMSが送信された時刻。

成功した応答は通常、 エラー = 0 そして内部のエントリー一覧 結果.SMS.

携帯電話から送信されたSMSの一覧

このエンドポイントを使用すると、モバイルデバイスから送信され、SMSMobileAPIアカウントに同期されたSMSメッセージを一覧表示できます。

重要： この機能はAndroidバージョンから利用可能です 4.1.20.

重要： この機能は デフォルトでは有効になっていません Androidアプリで。

プライバシー： 同期されたすべての情報は匿名化され、機密情報として扱われ、安全に処理されます。

履歴制限: このAPIは最後の 7日間.

注記： 標準APIエンドポイントを使用してSMSを送信する場合 https://api.smsmobileapi.com/sendsms/これらのSMSは、実際にあなたのモバイルデバイスから送信されたものであるため、このリストに表示される場合があります。

終点：

得る役職 https://api.smsmobileapi.com/log/sent/frommobile/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
date	オプション。正確な日付フィルター YYYY-MM-DD 形式。
date_from	オプション。期間の開始日 YYYY-MM-DD 形式。
date_to	オプション。期間の終了日 YYYY-MM-DD 形式。
period	オプション。事前定義された期間フィルター。許容値： today, yesterday, last_24h, last_3days, last_7days.
number	オプション。受信者の電話番号で絞り込む。
sIdentifiant	オプション。モバイル識別子でフィルタリングします。
message	オプション。SMSの内容でフィルタリングします。
search	オプション。グローバル検索 sIdentifiant, number, message, mobile_date_formatted、そして synchro_time.
sort_by	オプション。並べ替えフィールド。指定可能な値： sIdentifiant, number, message, mobile_date_ms, mobile_date_formatted, synchro_time.
sort_order	オプション。並べ替え順序： ASC または DESC.
limit	オプション。返される行の最大数。許容される最大値： 200.

返されたフィールド:

分野	説明
sIdentifiant	送信されたSMSに関連付けられた携帯電話識別子。
number	受取人の電話番号。
message	SMSの内容。
mobile_date_ms	元のSMSのタイムスタンプ（ミリ秒単位）。
mobile_date_formatted	モバイルデバイスから受信したフォーマット済みのデータ。
synchro_time	SMSがSMSMobileAPIに同期された日時。

リクエスト例：

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

フィルターを使用した例：

GET https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&date=2026-03-13&number=+15551234567&sort_by=synchro_time&sort_order=DESC

期間があらかじめ定義されている例：

GET https://api.smsmobileapi.com/log/sent/frommobile/?apikey=YOUR_API_KEY&period=last_7days&limit=200

JSONレスポンスの例：

{ "result": { "error": "0", "count": 200, "limit": 200, "history_limit_days": 7, "sort_by": "mobile_date_ms", "sort_order": "DESC", "sms": [ { "sIdentifiant": "508b004b4aadacc4", "number": "+15551234567", "message": "こんにちは、ご予約が確定しました。", "mobile_date_ms": 1774041004692, "mobile_date_formatted": "2026-03-20 22:10:04", "synchro_time": "2026-03-20 21:10:05" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+447700900123", "message": "認証コードは482915です。", "mobile_date_ms": 1774040902284, "mobile_date_formatted": "2026-03-20 22:08:22", "synchro_time": "2026-03-20 21:08:35" }, { "sIdentifiant": "e5b70a8a28b2ec3d", "number": "+33198765432", "message": "ご注文ありがとうございます。現在処理中です。", "mobile_date_ms": 1774026491230, "mobile_date_formatted": "2026-03-20 18:08:11", "synchro_time": "2026-03-20 17:19:19" } ] } }

回答の説明：

分野	説明
result.error	0 エラーなし。リクエストは正常に処理されました。
result.count	今回の応答で返されたSMSエントリの数。
result.limit	APIによって要求または適用される行の最大数。
result.history_limit_days	このエンドポイントを通じて取得可能な履歴の最大範囲（日数）。
result.sort_by	レスポンスにソートフィールドが適用されます。
result.sort_order	レスポンスに適用されるソート方向： ASC または説明.
result.sms	モバイルデバイスから送信された同期済みのSMSエントリを含む配列。
result.sms[].sIdentifiant	SMSを送信した携帯端末の識別子。
result.sms[].number	受取人の電話番号。
result.sms[].message	SMSメッセージの内容。
result.sms[].mobile_date_ms	元のモバイル端末のタイムスタンプ（ミリ秒単位）。
result.sms[].mobile_date_formatted	モバイル端末から読み取れる、人間が理解しやすい日付と時刻。
result.sms[].synchro_time	SMSエントリがSMSMobileAPIに同期された日時。

成功した応答は通常、 エラー = 0 そして内部のエントリー一覧 結果.SMS.

SMS受信

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

終点：

得る https://api.smsmobileapi.com/getsms/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
sIdentifiantPhone	オプション。特定の連携済み電話で受信したメッセージをフィルタリングします。
after_timestamp_unix	オプション。指定されたUNIXタイムスタンプ以降に受信したSMSのみを取得します。
onlyunread	はい = APIステータスによってまだ既読としてマークされていないメッセージのみを返します。

リクエスト例：

https://api.smsmobileapi.com/getsms/?apikey=YOUR_API_KEY を取得します。

JSONレスポンスの例：

{ "result": { "error": "", "sms": [ { "id": 466340, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320222332804", "indice": "27593", "message": "こんにちは、荷物が配達されました。", "number": "+15551234567", "guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466341, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:23:34", "timestamp_unix": 1774041814, "time_received": "20260320221005892", "indice": "27591", "message": "明日の予約が確定しました。", "number": "+447700900123", "guid": "BF3B38D7-8401-4A8C-8BA6-D8D58ACBB23E", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466324, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "21:08:24", "timestamp_unix": 1774040904, "time_received": "20260320220822763", "indice": "27590", "message": "空き次第、お電話ください。", "number": "+33198765432", "guid": "08C88E20-9B98-453F-B361-9BB06D3275D6", "alias": null, "apikey": "YOUR_API_KEY_HASH" }, { "id": 466156, "sIdentifiantPhone": "e5b70a8a28b2ec3d", "date": "2026-03-20", "hour": "19:05:22", "timestamp_unix": 1774033522, "time_received": "20260320200026246", "indice": "27588", "message": "リマインダー：アカウント審査が保留中です。", "number": "10001", "guid": "551B2CF4-9330-4DD2-B2BA-5A4026EEEB15", "alias": null, "apikey": "YOUR_API_KEY_HASH" } ] } }

回答の説明：

分野	説明
result.error	空の値は通常、APIからエラーが返されなかったことを意味します。
result.sms	受信したSMSエントリを含む配列。
result.sms[].id	受信したSMSエントリの内部固有識別子。
result.sms[].sIdentifiantPhone	SMSを受信した電話機の識別子。
result.sms[].date	SMSを受信した日付。
result.sms[].hour	SMS を受信した時刻。
result.sms[].timestamp_unix	受信したSMSのUNIXタイムスタンプ。
result.sms[].time_received	モバイル端末／アプリによって提供される、オリジナルの内部受信タイムスタンプ。
result.sms[].indice	同期プロセスからの内部メッセージインデックスまたは参照。
result.sms[].message	受信したSMSの内容。
result.sms[].number	送信者の電話番号またはショートコード。
result.sms[].guid	受信したSMSに割り当てられる固有のGUID。
result.sms[].alias	送信者に関連付けられたオプションのエイリアス（利用可能な場合）。ヌル.
result.sms[].apikey	メッセージレコードに関連付けられたAPIキー。ドキュメントの例では、この値はマスクする必要があります。

成功した応答は通常、空の文字列を返します。 エラー 値と内部のエントリのリスト 結果.SMS.

受信したSMSメッセージを既読にする

このAPIエンドポイントは、受信したSMSメッセージを1つ既読としてマークするために使用されます。 APIステータスのみ.
これによってスマートフォン上の既読ステータスは変更されません。

終点：

得る https://api.smsmobileapi.com/getsms/set-read/

パラメータ:

パラメータ	説明
apikey	必須あなたが持っている、または受け取る予定の API キー。
guid_message	必須既読としてマークするメッセージの GUID。

例：

https://api.smsmobileapi.com/getsms/set-read/?apikey=YOUR_APIKEY&guid_message=GUID_MESSAGE を取得します。

SMSエイリアスを更新

このAPIエンドポイントは、受信したSMSのGUIDを使用して、そのエイリアスを更新するために使用されます。

注記： の alias パラメータは空でも構いません。その場合、エイリアスはクリアされます。

終点：

得る役職 https://api.smsmobileapi.com/getsms/update/

パラメータ:

パラメータ	説明
apikey	必須 API キー。
guid	必須更新する受信SMSのGUID。
alias	必須このSMSに割り当てるエイリアス。現在のエイリアスをクリアするには、この値を空にしてください。

例：

GET https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=JohnDoe

エイリアスをクリアする例：

GET https://api.smsmobileapi.com/getsms/update/?apikey=YOUR_API_KEY&guid=GUID_OF_THE_MESSAGE&alias=

SMSを削除

このエンドポイントを使用すると、SMSMobileAPIサーバーのログからSMSメッセージを削除できます。

終点：

得る https://api.smsmobileapi.com/deletesms/

パラメータ:

パラメータ	説明
apikey	必須固有の API キー。
guid_message	固有のメッセージGUIDを使用して、特定のメッセージを削除します。
date_start	単独で使用した場合、指定した日付以降に記録されたすべてのメッセージを削除します。
date_end	一緒に使用すると開始日指定した日付範囲内のメッセージを削除する。

リクエスト例：

GET https://api.smsmobileapi.com/deletesms/?apikey=YOUR_API_KEY&guid_message=GUID_OF_THE_MESSAGE

JSONレスポンスの例：

{ "result": { "error": null, "count_delete": 1 } }

回答の説明：

分野	説明
result.error	ヌルこれは、削除リクエスト中にAPIからエラーが返されなかったことを意味します。
result.count_delete	サーバーから削除されたSMSログエントリの数。

注：削除されるのは、SMSMobileAPIサーバーのログに保存されているSMSのみです。モバイルデバイスに既に保存されているSMSメッセージは削除されません。

SMSの会話一覧

このAPIエンドポイントは、あなたのアカウントに関連付けられたSMSの会話履歴を表示するために使用されます。

各会話は電話番号ごとにグループ化され、関連する送受信SMSメッセージが含まれています。

注記： 会話の出発点は、 origineConversation パラメータ:

received: 会話は最初に受信した SMS から検出されます logsmsreceive
sent: 会話は最初に送信された SMS から検出されます logsmssent

注記： もし numero が指定されていない場合、API は最新の会話のみを返します。デフォルトでは、最後の 20 会話が返されます。

注記： 送信SMSの場合、 timearea_of_message 利用可能です（例： UTC+02) 表示される日付は、この値を使用して自動的に変換されます。この変換された日付は、並べ替えにも使用されます。

注記： もし resume=1各会話の最新メッセージのみが返されます。 resume_line_how 最新のメッセージをいくつ含めるかを定義する。

終点：

得る役職 https://api.smsmobileapi.com/conversation/sms/list/

パラメータ:

パラメータ	説明
apikey	必須 API キー。
origineConversation	必須会話リストの開始点を定義します。指定可能な値： received または sent.
numero	オプション特定の電話番号のみに結果を絞り込む。
date_from	オプション会話とメッセージの開始日フィルター。対応フォーマット： YYYY-MM-DD または完全な日時値。
date_to	オプション会話とメッセージの終了日フィルター。対応フォーマット： YYYY-MM-DD または完全な日時値。
sort	オプション会話の並べ替え順序。指定可能な値： DESC または ASC。デフォルト： DESC.
limit	オプション返される会話の最大数 numero 提供されていません。デフォルト: 20.
resume	オプション設定されている場合 1各会話の最新のメッセージのみが返されます。
resume_line_how	オプション会話ごとに返される最新メッセージ数 resume=1。デフォルト： 1.

行動の詳細：

受信したSMSは logsmsreceive.
送信SMSは以下から読み取られます logsmssent.
受信メッセージは常に返されます direction = "incoming".
送信メッセージは常に返ってくる direction = "outgoing".
連絡先エイリアスは以下から取得されます logsmsreceive.alias 入手可能な場合。
受信SMSの場合、モバイルSIDは sIdentifiant_pour_read.
送信SMSの場合、モバイルSIDは send_from_mobile_sIdentifiant.
送信SMSの場合、表示される日付は調整されます。 timearea_of_message このフィールドが空でない場合。

例1 - 受信したSMSから最新の会話を一覧表示する：

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received

例2 - 送信済みSMSから最新の会話を一覧表示する：

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent

例3 - 特定の電話番号をフィルタリングする：

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&numero=32470000001

例4 - 日付範囲でフィルタリングする：

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=received&date_from=2026-03-01&date_to=2026-03-31

例5 - 会話ごとに最後の3つのメッセージを含む再開モード：

GET https://api.smsmobileapi.com/conversation/sms/list/?apikey=YOUR_API_KEY&origineConversation=sent&resume=1&resume_line_how=3

成功例：

{ "success": true, "origineConversation": "received", "resume": 0, "resume_line_how": null, "conversations": [ { "phone_number": "+10470000001", "contact_alias": "John Doe", "messages": [ { "direction": "incoming", "message_id": "msg_1001", "date": "2026-03-13 08:45:12", "timestamp_utc": "2026-03-13T08:45:12Z", "message": "Hello, I would like more information.", "status": "received", "mobile_sid": "device_sid_1" }, { "direction": "outgoing", "message_id": "msg_1002", "date": "2026-03-13 10:46:03", "timestamp_utc": "2026-03-13T08:46:03Z", "message": "もちろん、何を知りたいですか？", "status": "送信済み", "mobile_sid": "device_sid_2" } ] } ] }

応答フィールド:

分野	説明
success	リクエストが成功したかどうかを示します。
origineConversation	会話リストを作成する際に使用される開始モード。
resume	再開モードが有効になっているかどうかを示します。
resume_line_how	再開モードが有効になっている場合に、会話ごとに返される最新の行数。
conversations	様々な会話。
phone_number	会話を特定するために使用された電話番号。
contact_alias	利用可能な場合は、電話番号に関連付けられた別名。
messages	会話内のSMSメッセージの配列。
direction	incoming 受信したSMSの場合、 outgoing 送信されたSMSについて。
message_id	メッセージの一意の識別子。
date	メッセージの日付を表示します。送信SMSの場合、この値は次のように調整できます。 timearea_of_message.
timestamp_utc	メッセージのUTCタイムスタンプ。
message	メッセージの内容。
status	received 受信SMSの場合、 sent 送信SMS用。
mobile_sid	メッセージを受信または送信したモバイルデバイスのSID。

エラー例：

{ "success": false, "error": "必須パラメータ「apikey」が不足しています" }

注：

もし numero が指定されている場合、API はこの電話番号に関連付けられた会話のみを返します。
もし numero が指定されていない場合、API は選択された発信元モードに従って最新の会話を返します。
電話番号ごとに、受信メッセージと送信メッセージが1つのタイムラインに統合されます。
送信メッセージのソートでは、調整されたローカル日付が考慮されます。 timearea_of_message 利用可能です。
再開モードは、ダッシュボード、ウィジェット、プレビュー、会話の要約などに便利です。

ゲートウェイ – 接続されているモバイルの一覧

接続されているモバイルを一覧表示 SMSゲートウェイ.

終点：

得る役職 https://api.smsmobileapi.com/gateway/mobile/list/

パラメータ:

パラメータ	説明
apikey	必須 API キー。
sid	正確な SID (sIdentifiant_pour_check) でフィルタリングします。
search	フィールド（SID、日付、バッテリー、バージョン、ラベルなど）で検索します。

例：

https://api.smsmobileapi.com/gateway/mobile/list/?apikey=YOUR_API_KEY を取得します。

注: 受信した SMS の統計は、モバイルアプリのバージョン 3.0.33.3 以降で利用できます。

ゲートウェイ – モバイルラベルを更新する

接続されているモバイルのラベル (nom_reference) を更新します。

終点：

得る役職 https://api.smsmobileapi.com/gateway/mobile/update/

パラメータ:

パラメータ	説明
apikey	必須 API キー。
sid	必須デバイスの SID (sIdentifiant_pour_check)。
label	新しいラベル
phone_number	新しい電話番号

例：

https://api.smsmobileapi.com/gateway/mobile/update/?apikey=YOUR_API_KEY&sid=SID&label=OfficePhone を取得します。

重要： ラベルは必須ですが、空でも構いません (ラベル=)。

ゲートウェイ – 接続されたモバイルを削除する

接続されているモバイルをゲートウェイから削除します (この SID のすべての履歴行を削除します)。

終点：

得る役職 https://api.smsmobileapi.com/gateway/mobile/delete/

パラメータ:

パラメータ	説明
apikey	必須 API キー。
sid	必須デバイスの SID (sIdentifiant_pour_check)。

例：

https://api.smsmobileapi.com/gateway/mobile/delete/?apikey=YOUR_API_KEY&sid=SID を取得します。

Webhook – SMS 受信

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

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

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

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

Webhook ペイロード

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

{ "date": "2025-01-20", "hour": "10:15:00", "time_received": "2025-01-20 10:14:50", "message": "こんにちは、これはテストです。", "number": "+123456789", "guid": "abcde12345" }

ペイロードフィールド:

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

Webhookエンドポイントの例

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

Webhookのテスト

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

トラブルシューティング

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

強化されたSMS

近日公開

認証

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

1. APIキー認証

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

2. OAuth2認証

OAuth2 はより安全な認証方法を提供します。
クライアントIDとクライアントシークレットを使用してアクセストークンを取得し、それを承認ヘッダ。

client_id と client_secret はダッシュボードで確認できます。
今すぐモバイルアプリをダウンロードまたはダッシュボードにアクセスする.

アクセストークンの取得


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=YOUR_CLIENT_ID" \

-d "client_secret=YOUR_CLIENT_SECRET"

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


curl -X POST https://api.smsmobileapi.com/sendsms \

-H "認証: ベアラー YOUR_ACCESS_TOKEN" \

-H "コンテンツタイプ: application/x-www-form-urlencoded" \

-d "受信者=+1234567890" \

-d "メッセージ=こんにちは"

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

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

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

SMSを送信

WSDL URL

https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl

パラメータ:

- recipients: 受信者の携帯電話番号。
- message: 送信するメッセージ。
- apikey: あなたが持っている、または受け取る予定の API キー。

例


require_once "lib/nusoap.php";


$client = new nusoap_client("https://api.smsmobileapi.com/sendsms/wsdl/sendsms.wsdl", true);

$error  = $client->getError();


$result = $client->call("sendSms", array("recipients" =>$_GET['recipients'],"message" =>$_GET['message'],"apikey" =>$_GET['apikey']));


print_r($result);

SMSとWhatsAppを送信

基本的な cURL コマンド


curl -X POST https://api.smsmobileapi.com/sendsms/ \

-d "recipients=PHONE_NUMBER" \

-d "message=YOUR_MESSAGE" \

-d "apikey=YOUR_API_KEY" 

-d "sendwa=1"

-d "sendsms=1"

SMSとWhatsAppを送信

公式 Python モジュールを使用してください: https://smsmobileapi.com/python/


import requests


url = "https://api.smsmobileapi.com/sendsms/"


payload = {"recipients":"PHONE_NUMBER","message":"YOUR_MESSAGE","apikey":"YOUR_API_KEY"}


response = requests.post(url, data=payload)

print(response.text)

SMS モバイル API - PHP SDK (Composer)

composer は smsmobileapi/sdk を必要とします

GitHub: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

SMSとWhatsAppを送信


const url = "https://api.smsmobileapi.com/sendsms/";

const data = {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"};

fetch(url,{method:"POST",headers:{"Content-Type":"application/x-www-form-urlencoded"},body:new URLSearchParams(data)})

.then(r=>r.text()).then(console.log);

SMSとWhatsAppを送信


const axios = require("axios");

axios.post("https://api.smsmobileapi.com/sendsms/", {recipients:"PHONE_NUMBER", message:"YOUR_MESSAGE", apikey:"YOUR_API_KEY"})

.then(r=>console.log(r.data));

SMSとWhatsAppを送信


require "net/http"

require "uri"

uri = URI.parse("https://api.smsmobileapi.com/sendsms/")

req = Net::HTTP::Post.new(uri)

req.set_form_data({"recipients"=>"PHONE_NUMBER","message"=>"YOUR_MESSAGE","apikey"=>"YOUR_API_KEY"})

res = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true){|http| http.request(req)}

puts res.body

簡単なフォームでAPIキーとサービスをテストするにはここをクリックしてください

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

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

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

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

アプリをダウンロード

API と開発者向けドキュメント

ツールと変更ログ

SMSを送信

終点：

パラメータ:

リクエスト例：

JSONレスポンスの例：

回答の説明：

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

終点：

パラメータ:

リクエスト例：

JSONレスポンスの例：

回答の説明：

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

終点：

パラメータ:

リクエスト例：

JSONレスポンスの例：

回答の説明：

携帯電話から送信されたSMSの一覧

終点：

パラメータ:

返されたフィールド:

リクエスト例：

フィルターを使用した例：

期間があらかじめ定義されている例：

JSONレスポンスの例：

回答の説明：

SMS受信

終点：

パラメータ:

リクエスト例：

JSONレスポンスの例：

回答の説明：

受信したSMSメッセージを既読にする

終点：

パラメータ:

例：

SMSエイリアスを更新

終点：

パラメータ:

例：

エイリアスをクリアする例：

SMSを削除

終点：

パラメータ:

リクエスト例：

JSONレスポンスの例：

回答の説明：

SMSの会話一覧

終点：

パラメータ:

行動の詳細：

例1 - 受信したSMSから最新の会話を一覧表示する：

例2 - 送信済みSMSから最新の会話を一覧表示する：

例3 - 特定の電話番号をフィルタリングする：

例4 - 日付範囲でフィルタリングする：

例5 - 会話ごとに最後の3つのメッセージを含む再開モード：

成功例：

応答フィールド:

エラー例：

注：

ゲートウェイ – 接続されているモバイルの一覧

終点：

パラメータ:

例：

ゲートウェイ – モバイルラベルを更新する

終点：

パラメータ:

例：

ゲートウェイ – 接続されたモバイルを削除する

終点：

パラメータ:

例：

Webhook – SMS 受信

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

Webhook ペイロード

ペイロードフィールド:

Webhookエンドポイントの例