開発ドキュメント - SMSMobileAPI
SMSmobileAPI 開発者ドキュメント

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文字に制限されません。より長いメッセージを送信できます）
shorturl 1 = メッセージ内のすべての URL が自動的に短縮 URL に変換されます
0 または空 = URL は短縮 URL に変換されません
sIdentifiant アカウントに複数の携帯電話が接続されている場合、どの携帯電話からSMSを送信するかを指定してください。各携帯電話には固有の識別子が割り当てられています。この識別子を使用してデバイスを選択してください。最初の利用可能な携帯電話からSMSを送信する場合は空欄のままにし、接続された携帯電話が1台だけの場合は空欄のままにしてください。
アクセスするにはアプリバージョン3.0.35.3以上が必要です。
sendwa 1 = メッセージは WhatsApp 経由で送信する必要があります。
sendsms 1 = メッセージは従来の SMS 経由で送信する必要があります。
（もし SMSを送信 空: デフォルトで送信されます。SMS をブロックするには 0 に設定します)
encrypt_message はい = 受信者が読むときにメッセージは暗号化されます。
受信者はメッセージを復号化するために一意のキーを入力する必要があります。
メッセージの暗号化について詳しくはこちら
schedule_timestamp SMSを送信する時刻を表す - UNIXタイムスタンプ（GMT 0）

例：

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

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

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

終点：

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

パラメータ: 

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

例： 

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

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

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

終点： 

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

パラメータ:

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

例：

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

SMS受信

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

終点：

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

パラメータ: 

パラメータ説明
apikey
必須
あなたが持っている、または受け取る予定の API キー。
sIdentifiantPhone 受信したSMSにリンクされた電話番号を特定できます
after_timestamp_unix 「タイムスタンプ」を入力すると、指定したUNIXタイムスタンプ以降の受信したSMSメッセージを一覧表示できます。
onlyunread 「はい」と入力すると、まだ既読としてマークされていない SMS メッセージのみを一覧表示できるようになります (API ステータスによる)。

例：

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

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

この API エンドポイントは、受信した 1 つまたは複数の SMS メッセージを API ステータスでのみ既読としてマークするために使用されます。
つまり、API 側で読み取りステータスが更新され、onlyunread=yes フィルターを使用するときに、すでに処理されたメッセージをフィルター処理できるようになります。

重要：
このアクションはスマートフォン自体の読み取りステータスには影響しません。変更は 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モバイルAPIのサーバーログからSMSメッセージを削除するために使用されます。

終点： 

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

パラメータ:

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

例：

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

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

 

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 に送信します。

{ "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 キーが必要です。これは、API リクエストを認証する簡単な方法です。

2. 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を送信

WSDL URL

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

パラメータ:

- recipients: 受信者の携帯電話番号。
- message: 送信するメッセージ。(メッセージの長さは 160 文字に制限されません。より長いメッセージを送信できます)
- 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 コマンド

SMSmobileAPI 経由で SMS を送信するには、次の 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"

PHP での cURL の例

PHP を使用している場合、cURL を使用して SMS を送信する方法は次のとおりです。

<?php

$url = 'https://api.smsmobileapi.com/sendsms/';
$data = array(
    'recipients' => 'PHONE_NUMBER',
    'message' => 'YOUR_MESSAGE',
    'apikey' => 'YOUR_API_KEY',
    'sendwa' => '1',
    'sendsms' => '1'
);

$options = array(
    CURLOPT_URL => $url,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => http_build_query($data),
    CURLOPT_RETURNTRANSFER => true,
);

$ch = curl_init();
curl_setopt_array($ch, $options);
$response = curl_exec($ch);
curl_close($ch);

echo $response;

?>

この PHP の例は、必要なパラメータを連想配列として渡しながら、cURL を使用して POST リクエストを SMSmobileAPI に送信する方法を示しています。

SMSとWhatsAppを送信

公式 Python モジュールを使用します。 https://smsmobileapi.com/python/

または手動で行うこともできます...

使用して リクエスト 図書館

の リクエスト ライブラリは、Python用の人気がありシンプルなHTTPライブラリです。SMSmobileAPI経由でSMSを送信するには、以下の手順に従ってください。

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)

使用して http.クライアント 図書館

の http.クライアント ライブラリは Python の標準ライブラリに含まれており、API と対話するためにも使用できます。

import http.client
import urllib.parse

conn = http.client.HTTPSConnection("api.smsmobileapi.com")

params = urllib.parse.urlencode({
    "recipients": "PHONE_NUMBER",
    "message": "YOUR_MESSAGE",
    "apikey": "YOUR_API_KEY"
})

headers = { "Content-type": "application/x-www-form-urlencoded" }

conn.request("POST", "/sendsms/", params, headers)
response = conn.getresponse()
data = response.read()

print(data.decode("utf-8"))
conn.close()

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

SMS モバイル API PHP SDK は Composer 経由で利用できるため、PHP アプリケーションに SMS 送信を簡単に統合できます。
composer は smsmobileapi/sdk を必要とします

詳細なドキュメント、インストール手順、使用例については、GitHub リポジトリをご覧ください。

🔗 GitHub 上の SMS モバイル API PHP SDK: https://github.com/SmsMobileApi/smsmobileapi-php/tree/main

GitHub では以下を見つけることができます:
✔️ 完全なインストールガイド
✔️ 使用例
✔️ APIリファレンスとベストプラクティス

ヘルプが必要ですか? お気軽に GitHub で問題を報告してください! 🎯

SMSとWhatsAppを送信

使用して フェッチ 翻訳

の フェッチ APIは、JavaScriptでHTTPリクエストを行うための最新かつ多用途な方法です。SMSmobileAPIを使ってSMSを送信する方法は以下の通りです。

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(response => response.text())
.then(result => console.log(result))
.catch(error => console.error("Error:", error));

使用 XMLHttpリクエスト

古いブラウザをサポートする必要がある場合は、 XMLHttpリクエスト 物体：

const xhr = new XMLHttpRequest();
const url = "https://api.smsmobileapi.com/sendsms/";

const data = "recipients=PHONE_NUMBER&message=YOUR_MESSAGE&apikey=YOUR_API_KEY";

xhr.open("POST", url, true);
xhr.setRequestHeader("Content-Type", "application/x-www-form-urlencoded");

xhr.onreadystatechange = function() {
    if (xhr.readyState === 4 && xhr.status === 200) {
        console.log(xhr.responseText);
    }
};

xhr.send(data);

SMSとWhatsAppを送信

使用して アクシオス 図書館

の アクシオス ライブラリはNode.jsで人気のHTTPクライアントです。SMSmobileAPI経由でSMSを送信するには、以下の手順を行ってください。

const axios = require('axios');

const url = 'https://api.smsmobileapi.com/sendsms/';
const data = {
    recipients: 'PHONE_NUMBER',
    message: 'YOUR_MESSAGE',
    apikey: 'YOUR_API_KEY'
};

axios.post(url, data)
.then(response => {
    console.log(response.data);
})
.catch(error => {
    console.error('Error:', error);
});

SMSとWhatsAppを送信

使用して ネット::HTTP 図書館

使用することができます ネット::HTTP SMSmobileAPI 経由で SMS を送信するための Ruby のライブラリ:

require 'net/http'
require 'uri'

uri = URI.parse("https://api.smsmobileapi.com/sendsms/")
request = Net::HTTP::Post.new(uri)
request.set_form_data(
    "recipients" => "PHONE_NUMBER",
    "message" => "YOUR_MESSAGE",
    "apikey" => "YOUR_API_KEY"
)

req_options = {
    use_ssl: uri.scheme == "https",
}

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
    http.request(request)
end

puts response.body
WhatsApp メッセージは当社の API を通じてのみ送信できます。 詳細はこちらをクリック.

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

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

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


開発者向けFAQ

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

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

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

アプリをダウンロード
💬 ライブチャット
💬 ライブチャット利用可能
ご質問やサポートが必要ですか?
私たちのチームがあなたをサポートします!
メールアドレスを入力してください
お客様のリクエストに対応するために:
ダッシュボード