バイブコーダー向けSMSゲートウェイAPI

SMS8は、ご自身のAndroidの上に構築された開発者向けSMSゲートウェイです。Claude Code、Cursor、Windsurf、あるいはcurlからSMS、MMS、OTP、USSDを送信できます。1つのキー、1つのベースURL、入出力はJSONです。

プレイグラウンド

ここから直接SMSゲートウェイを試せます。APIキーを貼り付け、電話番号とメッセージを入力し、送信を押してください。/services/send.phpへPOSTを行い、実際のJSONレスポンスを表示します。タブを切り替えると、curl、PHP、JavaScript、Python、Claude Code / Cursor用プロンプトとして同じリクエストを取得できます。

概要

SMS8のSMSゲートウェイは、機能ごとに1つのエンドポイントを持つ単一のホストを公開しています。パスパラメータもネストされたリソースもありません。すべてのアクションは、フォームエンコードされたフィールドを持つフラットなPOSTです。

• ベースURL: https://app.sms8.io/services/
• メソッド: すべてのエンドポイントでPOST
• ボディ: application/x-www-form-urlencoded
• レスポンス: application/json
• 認証: ボディにkey=YOUR_SMS8_API_KEY

認証

すべてのリクエストはPOSTボディでAPIキーを送信します。キーはアカウント単位で、すべてのエンドポイントを認可します。ダッシュボードのAPIページapp.sms8.io/api.phpから取得でき、いつでも再発行できます。古いキーは即座に無効化されます。

# すべてのリクエスト
key=YOUR_SMS8_API_KEY

最初のSMS

プライマリ端末を使ってペアリングされたAndroidから1つの番号へメッセージを送信します。YOUR_SMS8_API_KEYと宛先番号を置き換えてください。

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "number=+81901234567" \
  -d "message=SMS8からこんにちは"

レスポンス形式

すべてのエンドポイントはペイロードをsuccessエンベロープでラップします。

{
  "success": true,
  "data": {
    "messages": [
      {
        "ID": "1",
        "number": "+81901234567",
        "message": "SMS8からこんにちは",
        "deviceID": "1",
        "simSlot": "0",
        "status": "Pending",
        "type": "sms",
        "sentDate": "2026-05-24T10:30:00+00:00",
        "deliveredDate": null,
        "groupID": "…"
      }
    ]
  }
}

エラー

失敗時、successはfalseで、ボディに構造化されたerrorを含みます。

{
  "success": false,
  "error": {
    "code": 401,
    "message": "Invalid API key"
  }
}

SMS & MMS送信

1つのエンドポイントが4つの送信モードをカバーします: 単一メッセージ、バッチ(番号ごとに異なるメッセージ)、連絡先リストへの一斉配信、添付付きMMS。どのフィールドを送るかでモードを選びます。

1回の呼び出しでバッチ送信

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d 'messages=[{"number":"+81...","message":"こんにちは 1"},{"number":"+81...","message":"こんにちは 2"}]' \
  -d "option=2"

連絡先リストへ一斉配信

curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "listID=1" \
  -d "message=本日中限定セール"

メッセージ取得

# デバイス8のSIM 0で過去24時間の受信SMS
curl https://app.sms8.io/services/read-messages.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "status=Received" \
  -d "deviceID=8" \
  -d "simSlot=0" \
  -d "startTimestamp=$(( $(date +%s) - 86400 ))"

再送信

read-messagesと同じフィルタ形式。1つのID、グループ内のすべてのメッセージ、または時間枠内の特定ステータスのすべてのメッセージを再試行します。

連絡先

デバイス

モデル、SIMスロット、プライマリフラグを含むすべての有効な端末を返します。送信呼び出しでdevicesを構築する前に有用です。

USSD

ペアリングされた端末上でキャリアUSSDコードを実行し、レスポンスを読み戻します。プリペイド残高確認やキャリアメニューに便利です。

受信Webhook

ダッシュボードのAPIページでWebhook URLを設定してください。SMS8は受信したすべてのSMSをHMAC-SHA256署名付きでそのURLにPOSTします。受信側はペイロードがSMS8から来たもので改ざんされていないことを検証できます。

AIツールからは、MCPのcreate_webhookツール経由でWebhookを登録します。保存前にSSRFブロックリストに対してURLを検証します。

デバイス & SIMルーティング

すべての送信エンドポイントは同じルーティング制御を取ります。組み合わせて電話とSIMで負荷分散できます。

選択肢からランダムに1つの送信元を選ぶにはuseRandomDevice=1を設定します。OTPに便利です。

スケジューリング

送信を遅延させるにはscheduleをunixタイムスタンプとして渡します。同じメッセージを多くの番号にスケジュールしたり、未来の日付にバッチを送信したりできます。どちらも動作します。

残高

/services/send.phpをkeyフィールドのみで呼び出します。レスポンスのcreditsフィールドは残りクレジットまたは"Unlimited"を返します。

Claude Code、Cursor & Windsurfから使う

SMS8はmcp.sms8.ioにMCPサーバーを提供しており、上記のすべてのRESTエンドポイントをJSON-RPCツールでラップします。同じAPIキー、別アカウント不要です。

// ~/.config/claude/mcp-servers.json (Claude Code)
// ~/.cursor/mcp.json (Cursor)
// ~/.codeium/windsurf/mcp_config.json (Windsurf)
{
  "mcpServers": {
    "sms8": {
      "url": "https://mcp.sms8.io",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer YOUR_SMS8_API_KEY"
      }
    }
  }
}

PHP SDK

ダッシュボードのapp.sms8.io/api.phpでは、APIキーが事前入力された完全なPHPクラスがレンダリングされます。sendSingleMessage、sendMessages、sendMessageToContactsList、getMessageByID、getMessagesByStatus、resendMessageByID、addContact、unsubscribeContact、getBalance、sendUssdRequest、getDevicesを含みます。

$msg = sendSingleMessage("+81901234567", "SMS8からこんにちは");

$msg = sendSingleMessage("+81901234567", "デバイス1から", 1);

$msg = sendSingleMessage("+81901234567", "SIM 0から", "1|0");

$msg = sendSingleMessage("+81901234567", "2分後", null, strtotime("+2 minutes"));

C# SDK

完全なC#のAPIクラスもダッシュボードに事前入力されています。PHP SDKと同じ機能で、.NET / Unity / Xamarinプロジェクトですぐに使えます。

SMS.API.SendSingleMessage("+81901234567", "SMS8からこんにちは");

var msg = SMS.API.SendSingleMessage("+81901234567", "デバイス1から", "1");

var msgs = SMS.API.SendMessages(messages, SMS.API.Option.USE_ALL_SIMS);

curlレシピ

# OTPスタイルのメッセージを優先送信
curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "number=+81901234567" \
  -d "message=認証コード: 482910" \
  -d "prioritize=1" \
  -d "devices=1"

# メッセージクレジットを取得
curl https://app.sms8.io/services/send.php \
  -d "key=YOUR_SMS8_API_KEY"

# 連絡先を追加、存在すれば再購読
curl https://app.sms8.io/services/manage-contacts.php \
  -d "key=YOUR_SMS8_API_KEY" \
  -d "listID=1" \
  -d "number=+81901234567" \
  -d "name=山田" \
  -d "resubscribe=1"

FAQ

SMS8のSMSゲートウェイAPIとは何ですか?

SMSとMMSの送信、連絡先管理、USSD実行、受信箱読み取りを行うHTTP APIです。すべてのエンドポイントはhttps://app.sms8.io/services/配下のPOSTで、keyパラメータで認証します。メッセージはペアリングされたAndroid端末経由でルーティングされるため、A2P 10DLCもメッセージごとの料金もありません。

Claude Code、Cursor、WindsurfからこれをどうやってAIで使いますか?

AIツールにmcp.sms8.ioのMCPサーバーを追加し、SMS8 APIキーをBearerトークンとして指定します。MCPはsend_sms、send_otp、verify_otpといった同じRESTエンドポイントをJSON-RPCツールでラップします。AIツールセクションを参照してください。

Twilio番号なしで送信できますか?

はい。SMS8はご自身のAndroid端末とSIMカードをゲートウェイとして使用します。Twilio番号も、A2P 10DLC登録も、メッセージごとのキャリア料金も不要です。

受信SMSはどうやって受け取りますか?

ダッシュボードのAPIページでWebhook URLを設定してください。SMS8は受信したすべてのSMSをHMAC署名付きでそのURLにPOSTするので、ペイロードを検証できます。

どのようなレート制限がありますか?

SMSスループットはペアリングされた端末の速度とプランの月間ボリュームで制限されます。OTPフローでは番号あたり24時間で5コードのハードな上限と、設定可能な再送クールダウンが追加されます。

APIキーはどうやってローテーションしますか?

ダッシュボードのapp.sms8.io/api.phpから再生成してください。古いキーは即座に無効化されます。