OTP認証API
リセラー向け
使い捨てSMS認証番号を1件0.10ドルから1つのREST APIで再販売できます。即時プロビジョニング、未使用アクティベーションの全額返金、署名付きWebhook — 実際の通信事業者番号を使った独自のOTPプラットフォームを構築しましょう。
必要なすべてのワンタイムSMS認証のための1つのAPI
無料の公共SMS受信箱は公開されており、すでに主要なプラットフォームによってフラグが立てられています。使い捨て番号のために独自の通信事業者との関係を構築するのは、高価で、顧客が一度使って捨てるだけのものです。
VRNUM OTP APIは、オンデマンドでリアル通信事業者番号のライブ、プライベートなプールを提供します。番号を1つプロビジョニングし、コードを受け取り、その番号は他の誰にも表示されません — すべての表示価格にはすでにあなたのマークアップが適用されています。
注文から認証コードまで
4つの呼び出しでOTPライフサイクル全体をカバーします。
カタログを確認する
ライブサービス、国、価格については GET /otp-catalog を参照してください — 顧客に表示する前にマークアップを適用してください。
番号を注文する
POST /otp-numbers にサービス、国、Idempotency-Key を指定します。番号はすぐに返されます。
コードを取得する
GET /otp-numbers/:id で SMS をライブチェックするか、otp.completed ウェブフックイベントを待ちます。
再送信または返金
まだコードが届かない場合は /resend を試すか、/cancel でウォレットに即時全額返金されます。
1 回のリクエストで OTP 番号を注文する
clientReference は独自の不透明な ID です — 社内顧客記録との注文照合に添付してください。
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'OTP 注文の完全なライフサイクル
カタログ、注文、再送信、キャンセル/返金、ウェブフック — 一貫した JSON API で提供されます。
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceフルリクエスト/レスポンスのドキュメントとあなたのキーは、サインイン後にあなたのダッシュボードに配置されます。
誰がOTP検証APIを使うか
単一の検証ステップのために実際の電話番号が必要なあらゆる製品。
SMS検証プラットフォーム
自分のブランドで、各サービスに自分のマークアップをつけて、OTP番号を自分の顧客に再販。
QA & テスト自動化
個人の電話番号を使わずに、本番サービスで使い捨てテストアカウントを作成。
ボット & エージェンシーツール
クライアント向けに構築されたアカウント作成ワークフローのために、番号をプログラムでプロビジョニングします。
開発者向けツール
テレコムインフラを所有せずに、自分のアプリやSDKで「SMSで確認」を機能として提供します。
自分の顧客に課金できるほど信頼性があります
冪等性キー
タイムアウト時に安全に再試行 — 同じ冪等性キーは常に元の注文を返し、重複は発生しません。
署名付きウェブフック
otp.completed、number.provisioned、number.provisioning_failed イベントは X-VRNUM-Signature で署名されます。
自動再試行
配信に失敗したウェブフックは、バックオフスケジュール（5分、30分、2時間、6時間、24時間）に従って再試行され、それでも失敗した場合に諦めます。
透明なレート制限
各レスポンスにX-RateLimit-*ヘッダー付きで、キーごとに60リクエスト/分。
ウォレット資金による課金
請求書やサブスクリプションは不要 — 注文と返金は発生した瞬間に残高に反映されます。
安定したエラーコード
すべてのエラーは標準化されたJSONコードを返し、統合で確実に切り替えが可能です。
よくある質問
VRNUM APIを通じてOTP番号を再販できますか？
はい。otp-catalogおよびotp-numbersエンドポイントは再販価格のみを返します。サービスと国ごとに独自のマージンを設定できます — お客様にはVRNUMの内部コストは表示されません。
OTPコードが届かない場合はどうなりますか？
待機中のアクティベーションに対して POST /otp-numbers/:id/cancel を呼び出すと、ウォレットに全額返金されます。最初に再送エンドポイントを呼び出すこともできます。
API経由のOTPアクティベーションはどれくらい有効ですか？
各アクティベーションは作成から20分間有効です。コードが届かない場合は、有効期限が切れる前にキャンセルすると全額返金されます。
リトライ時に顧客に二重課金されないようにするにはどうすればよいですか？
POST /otp-numbers に Idempotency-Key ヘッダーを送信します。同じキーで同じリクエストをリトライすると、新しい注文が作成されるのではなく、元の注文が返されます。
ポーリングではなくリアルタイムの配信イベントを受け取ることはできますか？
はい。Webhookエンドポイントを登録すると、発生した瞬間に署名付きの otp.completed イベントを受け取ることができます。
APIでサポートされているサービスはどれですか？
WhatsApp、Telegram、Google、Instagram、Facebook、Discord など80以上のサービスが含まれます。最新のリストは GET /otp-catalog を呼び出してください。