Sanal Numara API
Bayiler için
Aylık ve yıllık özel sanal telefon numaralarını programlı olarak sağlayın, kendi yeniden satış fiyatınızı belirleyin ve tek bir SIM sahibi olmadan kendi SMS doğrulama markanızı oluşturun.
VRNUM API'si yerine kendi operatör anlaşmalarınızı kullanmak yerine neden inşa etmelisiniz
Gerçek mobil operatör numaralarını doğrudan temin etmek, SIM sözleşmeleri, donanım, uyumluluk yükü ve tek bir doğrulamayı satabilmeden önce aylarca süren bir hazırlık süresi anlamına gelir. VRNUM API'si bunların hepsini atlar.
50'den fazla ülkede aylık ve yıllık sanal numralardan oluşan canlı bir envantere anında erişim sağlarsınız ve API'nin döndürdüğü her fiyata kendi kâr marjınız dahil edilir. Müşterileriniz sadece sizin markanızı ve fiyatınızı görür.
API anahtarından ilk satışınıza kadar
Çalışan bir bayi entegrasyonu için dört adım.
API anahtarı oluştur
Ücretsiz bir VRNUM hesabı oluşturun ve Geliştiriciler sekmesinden bir anahtar üretin. Hesap başına bir aktif anahtar.
Cüzdanınızı fonlayın
Kripto ile bakiye yükleyin. Her sipariş bakiyenizden düşülür — fatura yok, manuel faturalama yok.
Kataloğu okuyun
Canlı ülkeler, abonelik koşulları ve fiyatlar için GET /catalog çağrısı yapın. Görüntülemeden önce kâr marjınızı ekleyin.
Talep üzerine tahsis
Bir numarayı anında atamak için Idempotency-Key ile POST /numbers yapın, ardından teslimat için sorgulama yapın veya web kancalarını kullanın.
Tek bir istekte bir numara tahsis et
clientReference kendi opak kimliğinizdir — siparişleri iç müşteri kayıtlarınızla uzlaştırmak için ekleyin.
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"
}'Tam sipariş yaşam döngüsünü çalıştırmak için ihtiyacınız olan her şey
Katalog, provisioning, SMS erişimi, yenileme, otomatik yenileme ve webhooklar — tutarlı bir 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/balanceTam istek/yanıt belgeleri ve anahtarlarınızDashboardGiriş yaptıktan sonra.
Sanal sayı API'si üzerine kim inşa ediyor
Telekom altyapısına sahip olmadan gerçek telefon numarasına ihtiyacı olan herhangi bir işletme.
Telekom satıcıları
Tek bir SIM sözleşmesi olmadan canlı operatör envanterinin üzerine kendi numara-hizmet olarak markanızı başlatın.
SaaS ve uygulama kurucuları
Ürününüzün onboarding veya doğrulama akışına birkaç API çağrısıyla telefon numarası sağlama ekleyin.
Geliştirici ajansları
Kendi operatör sözleşmelerinizi müzakere etmeden müşteri uygulamaları için numara sağlama özelliklerini sunun.
QA ve otomasyon ekipleri
Otomatik kayıt ve doğrulama test setleri için talep üzerine geçici ama gerçek numaralar sağlayın.
Demo için değil, üretim için tasarlandı
İdempotent anahtarlar
Zaman aşımında güvenle yeniden deneyin — aynı İdempotent-Anahtar her zaman orijinal siparişi döndürür, tekrar eden bir kopya asla olmayacaktır.
İmzalı web kancaları
number.provisioned, number.provisioning_failed ve sms.received olayları, X-VRNUM-Signature (HMAC-SHA256) ile imzalanmıştır.
Otomatik yeniden denemeler
Başarısız webhook teslimatları, pes etmeden önce geri çekilme programında (5dk, 30dk, 2saat, 6saat, 24saat) yeniden denenir.
Şeffaf hız limitleri
Her yanıtla X-RateLimit-* başlıkları ile anahtar başına 60 istek/dakika, böylece öngörülebilir şekilde geri çekilebilirsiniz.
Cüzdanla finanse edilen faturalama
API erişimi için fatura veya abonelik yok — siparişler başarılı oldukları anda bakiyenizden düşülür.
Stabil hata kodları
Her hata, entegrasyonunuzun güvenilir şekilde kullanabileceği normalleştirilmiş bir JSON kodu döndürür, sadece bir HTTP durumu değil.
Sıkça sorulan sorular
VRNUM sanal numaraları kendi markam altında yeniden satabilir miyim?
Evet. API yalnızca sizin satış fiyatınızı döner — müşterileriniz VRNUM'un iç maliyetini veya altyapı sağlayıcısını asla görmez. Her ülke ve hizmet için kendi fiyat artışınızı belirleyebilirsiniz.
Sanal numara API'sine nasıl erişim sağlayabilirim?
Ücretsiz bir VRNUM hesabı oluşturun, Geliştiriciler sekmesini açın ve bir API anahtarı oluşturun. Onay beklemenize gerek yok, aylık API ücreti yok — bir numara sağladığınızda yalnızca cüzdan bakiyenizden ödersiniz.
API hangi kimlik doğrulama yöntemini kullanıyor?
Bearer token (taşıyıcı jeton) kimlik doğrulaması. API anahtarınızı her istekte Authorization: Bearer başlığı veya X-API-Key başlığı olarak gönderin.
Bir istek zaman aşımına uğrarsa tekrar eden sipariş riski var mı?
Hayır. Her satın alma uç noktası bir Idempotency-Key başlığını kabul eder — aynı anahtarla aynı isteği tekrar deneyin ve tekrar eden ücretlendirme yerine orijinal siparişin yanıtını alırsınız.
Bir numara hazır olduğunda veya SMS geldiğinde nasıl bildirim alabilirim?
Geliştiriciler sekmesinden bir webhook URL'si kaydedin. VRNUM imzalı olayları (number.provisioned, number.provisioning_failed, sms.received) endpoint'inize POST eder ve başarısız teslimatları otomatik olarak tekrar dener.
API hız sınırları nelerdir?
Anahtar başına dakikada 60 istek. Her yanıt, temiz bir şekilde geri çekilebilmeniz için X-RateLimit-Limit, X-RateLimit-Remaining ve X-RateLimit-Reset başlıklarını içerir.
Bugün sanal numaraları yeniden satmaya başlayın
Ücretsiz bir hesap oluşturun, API anahtarınızı oluşturun ve ilk sanal numaranızı dakikalar içinde sağlayın.