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:

ProtonMail$0.01 itibaren
Apple$0.01 itibaren
Snapchat$0.01 itibaren
Yandex$0.01 itibaren
Yalla$0.01 itibaren
Microsoft$0.01 itibaren
Grindr$0.01 itibaren
TikTok$0.02 itibaren

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.

İlk numaranızı dakikalar içinde tedarik edin