Virtual Number API
untuk Reseller
Sediakan nomor telepon virtual bulanan dan tahunan secara khusus secara programatis, tentukan harga jual kembali Anda sendiri, dan bangun merek verifikasi SMS Anda sendiri — tanpa memiliki satu pun SIM.
Mengapa membangun di API VRNUM daripada kesepakatan operator Anda sendiri
Mendapatkan nomor operator seluler nyata secara langsung berarti kontrak SIM, perangkat keras, kepatuhan, dan waktu tunggu berbulan-bulan sebelum Anda dapat menjual satu verifikasi pun. API VRNUM melewati semua itu.
Anda mendapatkan akses instan ke inventaris langsung nomor virtual bulanan dan tahunan di lebih dari 50 negara, dengan margin Anda sendiri yang sudah termasuk dalam setiap harga yang dikembalikan oleh API. Pelanggan Anda hanya akan melihat merek dan harga Anda.
Dari kunci API hingga penjualan pertama Anda
Empat langkah untuk integrasi reseller yang berfungsi.
Hasilkan kunci API
Buat akun VRNUM gratis dan hasilkan kunci dari tab Developers. Satu kunci aktif per akun.
Isi dompet Anda
Top up dengan crypto. Setiap pesanan akan dikurangi dari saldo Anda — tidak ada faktur, tidak ada penagihan manual.
Baca katalog
Panggil GET /catalog untuk negara yang tersedia, ketentuan langganan, dan harga. Tambahkan markup Anda sebelum menampilkannya.
Provision sesuai permintaan
POST /numbers dengan Idempotency-Key untuk menetapkan nomor secara instan, kemudian lakukan polling atau gunakan webhook untuk pengiriman.
Provision sebuah nomor dalam satu permintaan
clientReference adalah ID buram Anda sendiri — lampirkan untuk merekonsiliasi pesanan dengan catatan pelanggan internal Anda.
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"
}'Semua yang Anda butuhkan untuk menjalankan siklus hidup pesanan penuh
Katalog, penyediaan, pengambilan SMS, perpanjangan, perpanjangan otomatis, dan webhook — satu API JSON yang konsisten.
/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/balanceDokumen permintaan/respons lengkap dan kunci Anda ada didasborsetelah Anda login.
Siapa yang membangun API nomor virtual
Setiap bisnis yang membutuhkan pasokan nomor telepon asli tanpa memiliki infrastruktur telekomunikasi.
Pengecer telekomunikasi
Luncurkan merek number-as-a-service Anda sendiri di atas inventaris operator langsung tanpa satu pun kontrak SIM.
Pendiri SaaS & aplikasi
Tambahkan penyediaan nomor telepon ke alur onboarding atau verifikasi produk Anda dengan beberapa pemanggilan API.
Agensi pengembang
Luncurkan fitur penyediaan nomor untuk aplikasi klien tanpa harus menegosiasikan perjanjian operator sendiri.
Tim QA & otomatisasi
Sediakan nomor sementara namun nyata sesuai permintaan untuk suite uji pendaftaran dan verifikasi otomatis.
Dibangun untuk produksi, bukan demo
Kunci idempoten
Coba ulang dengan aman saat terjadi timeout — Idempoten-Key yang sama selalu mengembalikan pesanan asli, tidak pernah duplikat.
Webhook yang ditandatangani
number.provisioned, number.provisioning_failed, dan sms.received events, ditandatangani dengan X-VRNUM-Signature (HMAC-SHA256).
Percobaan otomatis
Pengiriman webhook yang gagal dicoba ulang dengan jadwal backoff (5 menit, 30 menit, 2 jam, 6 jam, 24 jam) sebelum kami menyerah.
Batasan laju yang transparan
60 permintaan/menit per kunci dengan header X-RateLimit-* pada setiap respons, sehingga Anda dapat mundur secara prediktif.
Penagihan berbasis saldo dompet
Tidak ada faktur atau langganan untuk akses API — pesanan dikurangi dari saldo Anda begitu berhasil.
Kode kesalahan yang stabil
Setiap kesalahan mengembalikan kode JSON yang dinormalisasi yang dapat digunakan integrasi Anda secara andal, bukan hanya status HTTP.
Pertanyaan yang sering diajukan
Bisakah saya menjual kembali nomor virtual VRNUM dengan merek saya sendiri?
Ya. API hanya mengembalikan harga jual kembali Anda — pelanggan Anda tidak akan pernah melihat biaya internal VRNUM atau sumber operator yang mendasarinya. Anda menetapkan markup Anda sendiri per negara dan layanan.
Bagaimana saya mendapatkan akses ke API nomor virtual?
Buat akun VRNUM gratis, buka tab Developers, dan buat kunci API. Tidak perlu menunggu persetujuan, tidak ada biaya API bulanan — Anda hanya membayar dari saldo dompet Anda saat menyediakan nomor.
Autentikasi apa yang digunakan API?
Autentikasi token Bearer. Kirim kunci API Anda sebagai header Authorization: Bearer atau header X-API-Key di setiap permintaan.
Apakah pesanan duplikat menjadi risiko jika permintaan mengalami timeout?
Tidak. Setiap endpoint pembelian menerima header Idempotency-Key — ulangi permintaan yang sama dengan kunci yang sama dan Anda akan mendapatkan pesanan asli alih-alih dikenai biaya ganda.
Bagaimana saya diberitahu ketika nomor siap atau SMS tiba?
Daftarkan URL webhook dari tab Developers. VRNUM mengirim POST acara yang ditandatangani (number.provisioned, number.provisioning_failed, sms.received) ke endpoint Anda, secara otomatis mencoba ulang pengiriman yang gagal.
Apa batasan laju API?
60 permintaan per kunci per menit. Setiap respons menyertakan header X-RateLimit-Limit, X-RateLimit-Remaining, dan X-RateLimit-Reset sehingga Anda bisa mundur dengan aman.
Mulai menjual kembali nomor virtual hari ini
Buat akun gratis, buat kunci API Anda, dan sediakan nomor virtual pertama Anda dalam hitungan menit.