Sanal Numaralar için SMS Onay API'si

3 adımda hızlı başlangıç

Önce ücretsiz kayıt olun, bakiye yükleyin ve profilinizin API bölümünden API anahtarınızı alın. Örneklerde YOUR_KEY yerine kendi anahtarınızı yazın. İstekler GET ya da POST olabilir; POST ile api_key dahil tüm parametreleri istek gövdesinde form alanı (application/x-www-form-urlencoded) olarak gönderebilir, böylece anahtarın URL'de ve sunucu günlüklerinde görünmesini önleyebilirsiniz. İki taban adres eşdeğerdir: https://turonay.com/stubs/handler_api.php ve https://turonay.com/api/.

1. Bakiyenizi kontrol edin

getBalance bakiyenizi ACCESS_BALANCE:tutar biçiminde verir; anahtarınızın çalıştığını da böyle doğrularsınız. Tutar TRY cinsindendir ve açık aktivasyonlar için rezerve edilen miktar düşüldükten sonraki kullanılabilir bakiyedir.

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getBalance"
ACCESS_BALANCE:125.4000

2. Numara alın

service servis kodu (WhatsApp için wa), country ülke kimliğidir. Başarılı istek ACCESS_NUMBER:aktivasyon_kimliği:telefon döndürür. Fiyat bu anda bakiyenizde rezerve edilir, henüz tahsil edilmez. Kabul edeceğiniz en yüksek fiyatı maxPrice ile verirseniz fiyat aşıldığında numara alınmaz ve WRONG_MAX_PRICE:fiyat döner.

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getNumber&service=wa&country=62&maxPrice=20"
ACCESS_NUMBER:184213:905301234567

3. Kodu alın

Kod gelene kadar getStatus STATUS_WAIT_CODE döndürür; kod gelince STATUS_OK:kod. Ücret tam bu anda kesinleşir. Sürekli sorgulamak yerine imzalı webhook da kullanabilirsiniz.

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getStatus&id=184213"
STATUS_WAIT_CODE

curl "https://turonay.com/stubs/handler_api.php?api_key=YOUR_KEY&action=getStatus&id=184213"
STATUS_OK:123456

JSON isterseniz: getNumberV2

getNumberV2, getNumber ile aynı parametreleri alır ve başarıda JSON döndürür: aktivasyon kimliği, numara, fiyat, para birimi (949 = TRY), ülke, bitiş zamanı ve operatör. activationTime ve activationEndTime sunucu saatindedir (Europe/Istanbul, UTC+3), Y-m-d H:i:s biçimindedir ve saat dilimi içermez. Hata durumunda klasik metin kodları (NO_NUMBERS, NO_BALANCE, WRONG_MAX_PRICE:fiyat) gelir.

{
  "activationId": "184213",
  "phoneNumber": "905301234567",
  "activationCost": "12.50",
  "currency": 949,
  "countryCode": "62",
  "canGetAnotherSms": true,
  "activationTime": "2026-10-10 12:00:00",
  "activationEndTime": "2026-10-10 12:20:00",
  "activationOperator": "any"
}

Neden Turonay sanal numara API'si?

Amaç, entegrasyonu kısa tutmak ve maliyeti öngörülebilir kılmak.

API metotları

Her istekte api_key ve action gönderilir. Aşağıdaki tablo tüm action'ları ve tipik yanıtlarını özetler; ayrıntılar API dokümanı sayfasında.

Ücretlendirme: rezerve, tahsil, serbest bırak

Turonay'da sanal numara için ödeme, numaranın alındığı değil kodun geldiği andır. Böylece teslim edilmeyen aktivasyon için para kaybetmezsiniz. Akış dört durumdan oluşur:

Fiyat tavanı: maxPrice

Bakiyenizin numara fiyatını karşılaması gerekir; aksi halde NO_BALANCE döner. Fiyat sürprizlerine karşı maxPrice gönderin: güncel fiyat bu tutarı aşıyorsa satın alma yapılmaz ve WRONG_MAX_PRICE:fiyat ile gerçek fiyat bildirilir.

Webhook: kod bildirimini sunucunuza alın

Her saniye getStatus çağırmak yerine bir HTTPS adresi tanımlayın; kod geldiğinde ya da aktivasyon iptal olduğunda Turonay oraya imzalı bir POST gönderir. Kod kaydedildiğinde bildirim kuyruğa alınır, genellikle 1–2 dakika içinde ulaşır; getStatus ile yoklama alternatif ve yedek olarak kullanılabilir. Adresi ve gizli anahtarı profilinizden yönetir, test olayı gönderebilirsiniz.

• İmza: X-Turonay-Signature başlığında, zaman_damgası.gövde metni üzerinden HMAC-SHA256.
• Başlıklar: X-Turonay-Event, X-Turonay-Timestamp, X-Turonay-Signature, X-Turonay-Delivery.
• Yalnızca https adresleri kabul edilir.
• Başarısız teslimat, kademeli beklemeyle en fazla 8 kez denenir; aynı olay yeniden gelebileceği için işlemenizi tekrar-güvenli (idempotent) yazın.

POST /your-webhook HTTP/1.1
X-Turonay-Event: code_received
X-Turonay-Timestamp: 1791631200
X-Turonay-Signature: sha256=<hex>
X-Turonay-Delivery: dlv_<id>

signature = HMAC_SHA256(secret, timestamp + "." + body)

İmza doğrulama örnekleri, yük şeması ve yeniden deneme politikası için SMS API webhook rehberine bakın.

Dilinize göre örnekler

Aynı akış (numara al, kodu bekle, tamamla) üç dilde hazır örneklerle anlatılıyor.

Başka bir SMS aktivasyon API'sinden mi geliyorsunuz?

Turonay, yaygın handler_api protokolüyle uyumludur. Başka bir sağlayıcıdan geliyorsanız ve bu protokolü kullanan bir bot, panel ya da betik yazdıysanız geçiş genellikle üç değişiklikten ibarettir: taban adres, API anahtarı ve servis kodu / ülke kimliği doğrulaması. Canlıya almadan önce akışı mutlaka test edin.

Turonay bağımsız bir hizmettir; başka bir sağlayıcıyla bağlantılı değildir ve onların yerine geçtiğini iddia etmez. Bakiye aktarımı yapılmaz; Turonay hesabınıza ayrıca bakiye yüklersiniz.

Fiyatlar ve ödeme

Fiyatlar servis ve ülkeye göre değişir ve sürekli güncellenir; sabit bir liste yerine getPrices ile anlık değeri okursunuz. Güncel örnekler ve hesaplama için SMS API fiyatları sayfasına bakın. Tüm API tutarları TRY'dir; sitede TRY, USD veya RUB görüntüleyebilirsiniz.

Bakiyeyi ödeme sayfasından kartla (Shopier, Stripe), kriptoyla (Cryptomus, Heleket) veya banka havalesiyle yükleyebilirsiniz; hangi yöntemlerin açık olduğu para birimine ve bölgeye göre değişir. API erişimi için ayrıca abonelik ücreti yoktur.

Bayi olarak kendi marjınızla satın

Telegram botu, panel ya da web siteniz üzerinden müşterilerinize SMS onay satıyorsanız kademeli indirim ve marj hesabı için SMS onay bayiliği sayfasına göz atın.

Geliştirici kaynakları

Entegrasyonu hızlandıran hazır dosyalar:

• OpenAPI tanımı (openapi.json)
• Postman koleksiyonu

Tam metot ve hata kodu başvurusu için API dokümanı.

Sık sorulan sorular

Entegrasyona başlayın

Ücretsiz kaydolun, bakiye yükleyin ve ilk numaranızı birkaç dakikada alın.