バーチャル番号API
リセラー向け
専用の月額および年額バーチャル電話番号をプログラムで提供し、独自の再販価格を設定し、SIMを一切所有せずに独自のSMS認証ブランドを構築できます。
なぜ自社のキャリア契約ではなくVRNUM APIを使うのか
実際の携帯キャリア番号を直接調達するということは、SIM契約、ハードウェア、コンプライアンスの負担、そして一件の認証を販売するまでに数か月のリードタイムが必要になります。VRNUM APIを使えばそれらすべてをスキップできます。
50か国以上で月額・年額の仮想番号の在庫に即座にアクセスでき、APIが返す価格にはあなたのマージンが含まれています。お客様には常にあなたのブランドと価格しか表示されません。
APIキーから初回販売まで
稼働するリセラー統合のための4つのステップ。
APIキーの生成
無料のVRNUMアカウントを作成し、開発者タブからキーを生成します。アカウントにつき1つの有効なキー。
ウォレットに入金
暗号通貨でチャージします。すべての注文は残高から差し引かれます — 請求書や手動請求は不要。
カタログを確認
GET /catalog を呼び出して、利用可能な国、サブスクリプション条件、価格を確認します。表示する前にマークアップを追加してください。
オンデマンドでプロビジョニング
POST /numbers を Idempotency-Key と共に送信して番号を即座に割り当て、その後配信のためにポーリングまたはウェブフックを使用します。
1つのリクエストで番号をプロビジョニング
clientReference はあなた自身の不透明なIDです — 内部の顧客記録と照合するために注文に添付してください。
curl -X POST https://vrnum.com/api/v1/numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: order-8841" \
-d '{
"route": "<from catalog>",
"countryCode": "US",
"subscriptionOption": "month",
"clientReference": "order-8841"
}'フルオーダーライフサイクルを運用するために必要なすべて
カタログ、プロビジョニング、SMS取得、更新、自動更新、そしてウェブフック — すべて一貫したJSON APIで。
/api/v1/catalog/api/v1/numbers/api/v1/numbers/api/v1/numbers/:id/api/v1/numbers/:id/sms/api/v1/numbers/:id/renew/api/v1/numbers/:id/autorenew/api/v1/webhook/api/v1/balanceフルリクエスト/レスポンスのドキュメントとあなたのキーは、サインイン後のダッシュボードにあります。
バーチャルナンバーAPIを利用するのは誰か
電気通信インフラを所有せずに実際の電話番号を必要とするビジネス。
電気通信のリセラー
ライブキャリア在庫の上に独自のナンバー・アズ・ア・サービスブランドを立ち上げ、SIM契約を一つも結ぶことなく運用できます。
SaaSおよびアプリの創業者
数回のAPIコールで、製品のオンボーディングや認証フローに電話番号の提供機能を追加できます。
開発エージェンシー
独自のキャリア契約を交渉することなく、クライアントアプリ向けに番号提供機能を提供できます。
QAおよび自動化チーム
自動登録や認証テストスイートのために、使い捨てだが実際に有効な番号を必要に応じて提供できます。
デモではなく本番向けに構築
冪等キー
タイムアウト時も安全に再試行 — 同じ冪等キーは常に元の注文を返し、重複は発生しません。
署名付きウェブフック
number.provisioned、number.provisioning_failed、および sms.received イベントは、X-VRNUM-Signature（HMAC-SHA256）で署名されます。
自動再試行
失敗したWebhook配信は、諦める前にバックオフスケジュール（5分、30分、2時間、6時間、24時間）で再試行されます。
透過的なレート制限
キーごとに1分あたり60リクエストで、すべてのレスポンスに X-RateLimit-* ヘッダーが含まれるため、予測可能にバックオフできます。
ウォレット資金による課金
APIアクセスの請求書やサブスクリプションは不要で、注文が成功した瞬間に残高から差し引かれます。
安定したエラーコード
すべてのエラーは、HTTPステータスだけでなく、統一されたJSONコードを返すため、統合で信頼して分岐できます。
よくある質問
VRNUMの仮想番号を自分のブランドで再販できますか？
はい。APIはあなたの再販価格のみを返します — お客様にVRNUMの内部コストや元のキャリア情報が見えることはありません。国やサービスごとに自分のマークアップを設定できます。
仮想番号APIにアクセスするにはどうすればいいですか？
無料のVRNUMアカウントを作成し、開発者タブを開いてAPIキーを生成してください。承認待ちも、月額API料金もありません — 番号を提供する際にウォレット残高からのみ支払います。
APIはどの認証方式を使用していますか？
Bearerトークン認証です。APIキーを各リクエストのAuthorization: BearerヘッダーまたはX-API-Keyヘッダーとして送信してください。
リクエストがタイムアウトした場合、重複注文のリスクはありますか？
いいえ。すべての購入エンドポイントはIdempotency-Keyヘッダーを受け付けます — 同じキーで同じリクエストを再試行すると、重複請求ではなく元の注文が返されます。
番号が準備完了した時やSMSが届いた時に通知を受けるにはどうすればいいですか？
開発者タブからWebhook URLを登録してください。VRNUMは署名付きイベント（number.provisioned、number.provisioning_failed、sms.received）をあなたのエンドポイントにPOSTし、配信失敗時は自動で再試行します。
APIのレート制限は何ですか？
キーごとに1分あたり60リクエストです。すべてのレスポンスにはX-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetヘッダーが含まれているので、適切に待機できます。