Sanal Numara API'si: İstek Üzerine Telefon Numarası
SMSBulk sanal numara API'si telefon numarasını isteğe bağlı bir kaynağa çevirir: canlı stok ve fiyatı sorgulayın, tek POST ile geçici bir numara edinin, işiniz bitince bırakın. Operatör sözleşmesi yok, SIM donanımı yok, aylık ücret yok.
Keşfet, tedarik et, bırak
Katalog endpoint'leri herkese açıktır; kodunuz tek kuruş harcamadan pazarları karşılaştırabilir. Tedarik işlemi ise tek bir kimlik doğrulamalı POST'tur. Bu örnek üretime karşı yazıldığı gibi çalışır:
const BASE = 'https://smsbulk.net/api/v1';
const KEY = process.env.SMSBULK_API_KEY; // smsbulk_...
async function main() {
// 1) Browse the live catalogue (public, no key needed)
const { data: services } = await (await fetch(BASE + '/services')).json();
console.log('First service:', services[0].name, services[0].minPrice);
// 2) Where does Telegram have numbers right now, at what price?
const tg = await (
await fetch(BASE + '/services/telegram-verification/countries')
).json();
const target = tg.countries[0]; // ranked by speed tier and score
console.log('Best market:', target.name, target.price);
// 3) Provision a number there (charged to your balance)
const res = await fetch(BASE + '/activations', {
method: 'POST',
headers: { 'X-API-Key': KEY, 'Content-Type': 'application/json' },
body: JSON.stringify({ serviceCode: 'tg', countryIso: target.isoCode }),
});
if (!res.ok) throw new Error('HTTP ' + res.status);
const number = await res.json();
console.log('Provisioned:', number.phoneNumber, 'until', number.expiresAt);
// 4) Release it unused later and the charge is refunded automatically
await fetch(BASE + '/activations/' + number.id, {
method: 'DELETE',
headers: { 'X-API-Key': KEY },
});
}
main();Tüm endpoint'ler, parametreler ve yanıt şemaları API dokümantasyonu içinde tanımlıdır. Numaralar ön ödemeli bakiyenizden aktivasyon başına ücretlendirilir; kullanılmayan numarayı bırakmak tutarı otomatik iade eder.
Dört adımda entegrasyon
Hesap oluşturun
E-posta ile kaydolun ve küçük bir başlangıç bakiyesi yükleyin. Numara başına ödeyin, tekrarlayan ücret yok.
API anahtarı üretin
Anahtarlar panelde oluşturulur ve X-API-Key başlığıyla gönderilir. İstediğiniz an döndürün veya iptal edin.
Kataloğu sorgulayın
GET /v1/services ve GET /v1/services/{slug}/countries herkese açıktır: pazar bazında canlı stok, fiyat ve hız katmanı.
Numara tedarik edin
POST /v1/activations saniyeler içinde size özel bir numara döndürür. complete, cancel ve resend endpoint'leriyle yönetin.
Ekipler numarayı neden SMSBulk üzerinden tedarik ediyor
Bir numara tedarik API'sinin tek işi vardır: iş akışınız numara istediğinde çalışan bir tane belirir; akış bitince de o numaranın faturasına mahkum kalmazsınız.
Anında tedarik
Taşıma yok, operatör onboarding'i yok, SIM kargosu beklemek yok. Tek POST, saniyeler içinde canlı ve size özel bir numara döndürür.
Şeffaf pazar verisi
Herkese açık katalog, ülke başına fiyatı, stoğu ve ortalama SMS varış hızını sunar; kodunuz en iyi pazara otomatik yönlenebilir.
REST üzerinden tam yaşam döngüsü
Tedarik, sorgulama, yeni SMS isteme, tamamlama veya iptal: her durum değişikliği bir endpoint. Numaralar her orkestrasyona takılır.
Numara başına ödeme, sessizlikte iade
Her aktivasyon ön ödemeli bakiyeden tek tek ücretlendirilir. Numaraya hiç mesaj gelmezse tutar otomatik iade edilir.
Küresel havuz
Her bölgeden, canlı stoklu numara. Pazarı ISO koduyla açıkça seçin ya da katalog sıralamasından koda seçtirin.
Gerektiğinde daha uzun süreli numara
Tek seferlik aktivasyonlar dakikalar yaşar. Aynı numara günlerce veya haftalarca gerekiyorsa numara kiralama aynı bakiyeden bunu karşılar (kiralamalar bugün panelden yönetilir).
Canlı tedarik fiyatları
Numaralar servis ve ülkeye göre fiyatlanır. Aşağıdakiler katalogdan gelen canlı başlangıç fiyatlarıdır; bu sayfada saatlik yenilenir:
Kodunuz aynı veriyi okuyabilir: GET /v1/services katalog geneli başlangıç fiyatlarını, GET /v1/services/{slug}/countries pazar bazında kesin fiyatı döndürür.
Geçici, tek kullanımlık veya size özel: aynı API
Geçici numara API'si, tek kullanımlık numara API'si ya da geliştiriciler için telefon numarası API'si arayın; altta yatan ihtiyaç aynıdır: kod istediğinde beliren, sözleşmesiz kaybolan numaralar. Bir aktivasyon, ömrü boyunca yalnızca size ait özel bir numara verir; siz tutarken asla paylaşılmaz. Onu herkese açık SMS listelerinden ayıran budur.
Tipik entegrasyonlar: kayıt akışlarını pazar pazar doğrulayan QA takımları, kurumsal hesap başına numara açan onboarding boru hatları, gerçek numaraları üçüncü taraf formlardan uzak tutan gizlilik katmanları ve bölgeye özgü varlık gerektiren araştırma araçları.
Asıl ihtiyacınız numaradan çok doğrulama koduysa, SMS doğrulama API'si sayfası OTP döngüsünü uçtan uca anlatır.
AI ajanları için numara
Ajanlar özel HTTP kodu yazmadan numara tedarik edip yönetebilir: resmi SMSBulk MCP sunucusu kataloğu, aktivasyonları ve cüzdanı yerel araçlar olarak sunar. Ajan çalışma ortamınıza MCP sunucusu dokümantasyonu ile bağlayın.
Sanal numara API'si SSS
API üzerinden sanal telefon numarasını nasıl alırım?
Servis kodu ve ülke ISO koduyla POST /v1/activations çağırın. Yanıt, size özel bir telefon numarası ve sorgulama, tamamlama, iptal için kullanacağınız bir id içerir. Tam akış yukarıdaki kod örneklerinde.
Numaranın hangi ülkeden olacağını seçebilir miyim?
Evet, countryIso parametresi pazarı seçer. GET /v1/services/{slug}/countries bir servisin şu anda stoğu olan her ülkeyi, her birinin kesin fiyatıyla gösterir.
Numaralar özel mi, paylaşımlı mı?
Her aktivasyon size özel bir numara ayırır. Ona gelen kodlar yalnızca sizin hesabınızdan görülür; gelen mesajı herkesin okuyabildiği açık SMS sayfalarının aksine.
Kullanılmayan numaralara ne olur?
Numara hiç SMS almadıysa iptal etmek (veya süresinin dolmasını beklemek) tutarı bakiyenize otomatik iade eder. Sessizlik için asla faturalandırılmazsınız.
Bir numarayı günlerce veya haftalarca tutabilir miyim?
Evet, bu tek seferlik aktivasyon değil kiralamadır. Kiralamalar aynı bakiyeden çalışır ve panelden yönetilir; canlı süreler ve fiyatlar için numara kiralama sayfasına bakın.
SDK var mı, yoksa ham HTTP ile mi entegre olurum?
API düz REST ve JSON'dır; SDK gerekmeden her HTTP istemcisi çalışır. SMS-Activate protokolü için yazılmış araçlar da SMS-Activate uyumlu API dokümanları üzerinden çalışır; AI ajanları resmi MCP sunucusunu kullanabilir.
Keşfetmeye devam edin
Bu numaraların üzerine doğrulama akışı mı kuruyorsunuz? SMS doğrulama API'si rehberi OTP döngüsünü anlatır. Aynı numara daha uzun mu kalsın? numara kiralama sayfasına bakın.
