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 を設定するには、次の手順に従います。
- アカウントにログインしてください SMS モバイル API ダッシュボード.
- に移動 Webhook設定 セクション。
- Webhook URLを入力します(例:
https://example.com/webhook-endpoint
- クリックして Webhook を保存 ボタン。
- 保存すると、システムは設定された 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 は、弊社ではアクセスできないため削除されません。
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/
または手動で行うこともできます...
`requests` ライブラリの使用
`requests` ライブラリは、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)
この例では、特定の電話番号にメッセージを送信する、SMSmobileAPI への単純な POST リクエストを示します。
`http.client` ライブラリの使用
`http.client` ライブラリは 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()
この例では、`http.client` ライブラリを使用して API に POST リクエストを送信する方法を示します。パラメータは URL エンコードされ、適切なヘッダーとともに送信されます。
SMSとWhatsAppを送信
`fetch` API の使用
`fetch` 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));
この例では、ほとんどの最新ブラウザでサポートされている `fetch` API を使用して POST リクエストを送信する方法を示します。
`XMLHttpRequest` の使用
古いブラウザをサポートする必要がある場合は、`XMLHttpRequest` オブジェクトを使用できます。
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);
この例では、`XMLHttpRequest` を使用して POST リクエストを送信し、`fetch` をサポートしていない可能性のある古いブラウザとの互換性を確保する方法を示します。
SMSとWhatsAppを送信
`axios` ライブラリの使用
`axios` ライブラリは、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);
});
この例では、Node.js で `axios` を使用して POST リクエストを送信し、SMSmobileAPI と対話する方法を示します。
SMSとWhatsAppを送信
`Net::HTTP` ライブラリの使用
Ruby の `Net::HTTP` ライブラリを使用して、SMSmobileAPI 経由で SMS を送信できます。
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
この例では、Ruby で `Net::HTTP` を使用して POST リクエストを SMSmobileAPI に送信する方法を示します。