その他

SMS4You パブリック API：SMS、OTP、仮想番号を受信するための REST API

SMSやメールを受信するためのSMS4You REST API：仮想番号の購入、OTPコードの受信、Webhook、現在の料金、OpenAPIドキュメント、およびSMS-Activateとの互換性。

SMS4Youチーム5分で読めます2026/10/21 更新
SMS4You パブリック API：SMS、OTP、仮想番号を受信するための REST API

SMS4You パブリック API のご紹介：SMS の受信と番号管理を自動化

多くのお客様が待ち望んでいた「SMS4You」パブリックAPIの提供開始を発表できることを大変嬉しく思います。これにより、これまでアカウント内で手動で行っていたすべての操作――番号の購入、SMSやメールからのコードの取得、残高や料金の確認――をプログラムで実行できるようになります。 スクリプト、ボット、登録システムなどが、クリック一つせずに「SMS4You」と直接連携できるようになります。

以下では、今回リリースされた機能の詳細、その必要性、そして5分で始められる方法について解説します。

主な機能の概要

  • OTP アクティベーション（SMS 受信）およびメールアクティベーションのための、フル機能の REST API。

  • 国、サービス、現在の価格のカタログ — アカウントに表示されるすべての情報は、API からも利用可能です。

  • Webhook：コードやステータスの更新情報が、継続的なポーリングを必要とせずに自動的にサーバーに送信されます。

  • SMS-Activateプロトコルとの互換性：アドレスを1つ変更するだけで、既存の統合機能を移行できます。

  • アカウント内でご自身で作成したトークンによるシンプルな認証。

  • ブラウザ上で直接リクエストをテストできるインタラクティブなドキュメント。

APIが必要な理由

アクティベーションの数が少ない場合は、手動で番号を購入する方法でも問題ありません。しかし、登録数が数十や数百に達したり、一括処理を行ったり、自社製品に SMS 受信機能を統合したりするようになると、インターフェースを操作するのは煩雑になります。 APIはまさにこの問題を解決します。コード内でロジックを一度定義するだけで、それ以外のすべてが、規模や時間帯を問わず自動的に実行されます。

本APIが構築された代表的なシナリオ：

  • 自社ソフトウェア内での自動アカウント登録および本人確認；

  • 多数の電話番号を連続して処理・テストする必要がある一括処理；

  • SMS認証コードの受信機能をサービスや製品に直接統合すること；

  • 他のプロバイダー向けに構築された既存の連携機能の移行。

APIでできること

1. ターンキー方式のアクティベーション：番号の購入からコードの受信まで

アクティベーションの全ライフサイクルは、直感的なRESTエンドポイントを通じて利用可能です：

  • サービスと国を選択し、空き状況と価格を確認；

  • 1回のリクエストで番号を購入；

  • 受信したSMS（メールアクティベーションの場合はメール）を取得；

  • SMSの処理完了、キャンセル、または再送信の要求——ステータスを完全に制御できます。

主要な2つの製品、SMS受信（OTP）とメールアクティベーションの両方がサポートされています。各アクティベーションには一意の識別子が付与されており、後で参照する際に使用できます。

2. 現在のカタログと価格

本APIはリアルタイムのデータを提供します：

  • 国コード付きの国一覧；

  • サービス一覧（SMSおよびメール用）；

  • 特定のサービスまたは国ごとの料金、およびページ単位で表示される完全な料金表。

重要な注意点：表示される料金には、お客様の個人割引が適用された金額が反映されています。APIのレスポンスに表示される金額は、残高から実際に差し引かれる金額と完全に一致します。

3. Webhook：コードが自動的に通知されます

SMSメッセージを待つ間、サーバーに絶えずポーリングを行うのは非効率的で時間がかかります。そのため、SMS4YouではWebhookを提供しています。新しいメッセージが届いたり、アクティベーションステータスが変更されたりすると、指定されたアドレスに自動的にHTTPリクエストを送信します。

  • ポーリングを行うことなく、イベントを即座に受け取ることができます。

  • 各リクエストにはHMAC署名が添付されているため、リクエストが実際に当社から送信されたものであることを確認できます；

  • お客様のサーバーが一時的に利用できない場合に備え、リトライ機能を実装しています；

  • ホワイトリストによって受信トラフィックを制限しているユーザー向けに、Webhookが送信されるIPアドレスのリストを公開しています。

REST APIと組み合わせることで、統合が完成します。お客様ご自身でリクエストを送信し、プッシュチャネルを通じて更新情報を受け取ることができます。

4. SMS-Activateとの互換性：書き換え不要の移行

これは当社が特に誇りに思っている点です。すでにSMS-Activate APIを基盤として構築されたソフトウェアをお持ちの場合、統合部分を書き直す必要はありません。SMS4Youは互換性のあるプロトコルをサポートしています。サーバーアドレスを当社のものに変更し、ご自身のキーを置き換えるだけで済みます。

既存のコード、ライブラリ、ボットはそのまま動作し続けますが、SMS4Youの電話番号、料金体系、品質が利用できるようになります。これにより、当社への切り替えは、数週間の開発作業を要するのではなく、設定ファイルの1行を変更するだけで済みます。

5. 安全かつシンプルな認証

スクリプト内にユーザー名やパスワードを記述する必要はありません。アカウントにログインし、「API トークン」タブで個人用トークンを作成して、リクエストで使用してください。トークンの渡し方は3通りあります。お使いのライブラリに最も適した方法をお選びください：

  • ヘッダー内 Authorization: Bearer <api token>;

  • ヘッダー X-Api-Token: <api token>;

  • クエリパラメータとして ?api_token=<api token>.

複数のトークン（例えば、プロジェクトごとに個別のトークン）を作成でき、侵害されたトークンは他のトークンに影響を与えることなくいつでも無効化できます。トークンの値は作成時に一度だけ表示され、その後はユーザー自身のみが保管します。

6. 実践的なドキュメント

OpenAPI に基づいたインタラクティブなドキュメントを用意しています。すべてのエンドポイントが説明され、各フィールドの型が指定されており、ターミナルを開かずにページから直接リクエストを実行できます。また、Webhook や SMS-Activate と互換性のあるプロトコルに関するセクションも別途用意されています。

ドキュメントは docs.sms4you.org でご覧いただけます。

5分で始めよう

基本API URL： https://api.sms4you.org/api/v1

ステップ1. アカウントの残高と割引を確認する

Bash
curl https://api.sms4you.org/api/v1/me \
  -H "Authorization: Bearer YOU TOKEN"
JSON
{
  "data": {
    "name": "Ivan",
    "email": "[email protected]",
    "email_verified": true,
    "balance": "12.3456",
    "currency": "USD",
    "discount_percent": 5
  }
}

ステップ2. 希望するサービスの料金を確認する

Bash
curl "https://api.sms4you.org/api/v1/prices?service_id=SERVICE_ID" \
  -H "Authorization: Bearer YOU TOKEN"

ステップ3. 電話番号を購入する

Bash
curl -X POST https://api.sms4you.org/api/v1/activations \
  -H "Authorization: Bearer YOU TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"service_id": 123, "country_id": 7, "price": "0.20"}'

応答には、電話番号とアクティベーションコードが含まれます。

ステップ4. 受信したSMSを確認する

Bash
curl https://api.sms4you.org/api/v1/activations/{ACTIVATION_ID}/messages \
  -H "Authorization: Bearer YOU TOKEN"

また、Webhookを設定しておけば、この手順は不要です。コードは自動的に送信されます。

制限と信頼性

  • すべてのユーザーにとってサービスが安定して利用できるよう、リクエストの頻度には制限が設けられています（デフォルトでは1分あたり最大120リクエスト）。

  • エラーメッセージを含め、すべての応答は統一された形式で返されます。具体的には、明確なコード、人間が読み取れるメッセージ、そして必要に応じて詳細情報です。コードでの処理も非常に簡単です。

  • 購入には、標準的なセキュリティ対策として、本人確認済みのメールアドレスが必要です。

対象ユーザー

  • 自社製品内でSMSメッセージを受信する必要がある開発者。

  • 登録が絶え間なく流入するアービトラージおよびマーケティングチーム。

  • 電話番号による認証を含むシナリオをテストするQAチーム。

  • すでに SMS-Activate 対応のソフトウェアを利用しており、移行の手間をかけずにプロバイダーを切り替えたい方。

今後の展望

パブリックAPIは、私たちが今後も発展させていく基盤です。皆様からのご要望に耳を傾けながら、対応製品や機能の拡充を図ってまいります。特定のエンドポイントやシナリオが不足している場合は、サポートチャットからご連絡ください。すべてのご意見を確認し、真に必要なものを優先的に対応いたします。

今すぐお試しください：

  1. アカウントにログインし、「APIトークン」タブでトークンを作成してください。

  2. docs.sms4you.org でドキュメントを開いてください。

  3. 最初のリクエストを送信し、あとは自動化しましょう。

統合機能をお楽しみください。メッセージが時間通りに届くことを願っています。

共有

関連記事

SMS4YOUにおける2段階認証（2FA）としてのハードウェアセキュリティキー

SMS4YOUにおける2段階認証（2FA）としてのハードウェアセキュリティキー

SMS4YOUで、ハードウェアセキュリティキーによる二要素認証を有効にします。YubiKeyおよびFIDO2に対応しており、パスワードと物理キーを組み合わせた安全なログインが可能で、複数のデバイスにも対応しています。

続きを読む
オンラインSMS用バーチャル番号 - その概要と仕組み | SMS4YOU

オンラインSMS用バーチャル番号 - その概要と仕組み | SMS4YOU

オンラインでSMSを受信するための仮想番号 - 個人のSIMカードがなくても、アプリやSNSに安全に登録できます。190カ国以上、3,000以上のサービスに対応。有効化は0.01ドルから、番号のレンタルは1日3ドルから。

続きを読む
オンラインで認証コードを取得する方法：有効化するための最速の方法

オンラインで認証コードを取得する方法：有効化するための最速の方法

オンライン認証コード、SMSコードの取得、SIMフリー端末での認証、登録用のクラウド番号、オンラインでのSMS受信、アクティベーションコード、SMS4YOU、電話番号認証

続きを読む
オンラインでのSMS受信：あらゆるサービスへの登録に役立つ汎用的なソリューション

オンラインでのSMS受信：あらゆるサービスへの登録に役立つ汎用的なソリューション

SIMカードなしでオンラインでSMSを受信できます。仮想番号をレンタルして、Telegram、WhatsApp、Google、アプリストアへの登録が可能です。SMS4YOUなら、高速・安全・匿名で利用できます。

続きを読む