Her IP için dakikada 60 istek sınırı vardır. Limit aşılırsa API geçici olarak NO_CONNECTION (HTTP 429) döner.

SMS-Activate Protokolü Uyumlu API

API & Entegrasyonlar: Sanal Numarayı Kendi Sisteminize Bağlayın

Turonay Reseller API ile numara alma, kod okuma ve iptal işlemlerini kendi web sitenize, botunuza veya otomasyon panelinize saniyeler içinde entegre edin. API'miz yaygın SMS-Activate (handler_api) protokolüyle uyumludur; mevcut kütüphanelerinizi neredeyse hiç değiştirmeden kullanabilirsiniz.

API Anahtarımı Al Dokümantasyona Git

REST

Basit GET Tabanlı İstek

60/dk

IP Başına İstek Limiti

7/24

Otomatik Numara Teslimi

Kolay Entegrasyon

Tek bir uç nokta ve API anahtarınızla numara alın. PHP, Python, Node.js veya herhangi bir HTTP istemcisiyle dakikalar içinde bağlanın.

SMS-Activate Uyumu

getBalance, getNumber, getStatus ve setStatus aksiyonları standart protokolle birebir uyumludur.

Otomatik İade

Kod gelmeyen numarayı setStatus=8 ile iptal ettiğinizde ücret bakiyenize anında ve otomatik iade edilir.

Başlarken

API'yi kullanmak için önce bir Turonay hesabına ve bakiyeye ihtiyacınız var. Profil sayfanızdan kişisel API anahtarınızı alın. Tüm istekler aşağıdaki temel adrese GET yöntemiyle gönderilir ve yanıtlar düz metin (plain text) olarak döner:

https://turonay.com/api/index.php?api_key=API_ANAHTARINIZ&action=AKSIYON

İstek sınırı IP başına dakikada 60'tır; aşıldığında API NO_CONNECTION (HTTP 429) döner. Numara alabilmeniz için hesabınızda yeterli bakiye bulunmalıdır.

Uç Noktalar (Endpoints)

Aksiyon	Parametreler	Açıklama	Örnek Yanıt
getBalance	api_key	Hesabınızın güncel bakiyesini döndürür.	ACCESS_BALANCE:150.00
getNumber	api_key, service, country	Seçtiğiniz servis ve ülke için yeni bir numara kiralar, sipariş ID'si oluşturur.	ACCESS_NUMBER:12345:447700900123
getStatus	api_key, id	Numaraya gelen SMS kodunun durumunu sorgular.	STATUS_OK:123456
setStatus	api_key, id, status	`status=1` işlemi onaylar, `status=8` iptal eder ve ücreti iade eder.	ACCESS_CANCEL

Örnek İstek (cURL)

# Bakiye sorgula
curl "https://turonay.com/api/index.php?api_key=KEY&action=getBalance"

# Numara al (örn. Telegram / İngiltere)
curl "https://turonay.com/api/index.php?api_key=KEY&action=getNumber&service=tg&country=44"

# Kodu sorgula
curl "https://turonay.com/api/index.php?api_key=KEY&action=getStatus&id=12345"

# İptal et ve iade al
curl "https://turonay.com/api/index.php?api_key=KEY&action=setStatus&id=12345&status=8"

Hata Kodları

BAD_KEY: API anahtarı geçersiz veya boş.
NO_BALANCE: Numara için bakiyeniz yetersiz.
BAD_SERVICE: Servis veya ülke parametresi eksik/hatalı.
NO_NUMBERS: Seçilen servis/ülke için stokta numara yok.
NO_CONNECTION: Sağlayıcıya ulaşılamadı veya istek limiti aşıldı.

Sık Sorulan Sorular

API kullanımı, limitler ve entegrasyon hakkında merak edilenler.

Destek Merkezi

API anahtarımı nereden alırım?

Turonay hesabınıza giriş yaptıktan sonra Profil sayfanızdan kişisel API anahtarınıza ulaşabilir ve gerektiğinde yenileyebilirsiniz.

Mevcut SMS-Activate kütüphanem çalışır mı?

Evet. API'miz handler_api protokolüyle uyumludur; yalnızca temel adresi Turonay'ın uç noktasıyla değiştirmeniz genellikle yeterlidir.

İstek limiti nedir?

Her IP için dakikada 60 istek sınırı vardır. Limit aşıldığında API geçici olarak NO_CONNECTION (HTTP 429) yanıtı döner.

Kod gelmeyen numaranın ücretini iade alır mıyım?

Evet. Numarayı setStatus=8 ile iptal ettiğinizde ücret bakiyenize otomatik olarak iade edilir. Yalnızca başarılı işlemler ücretlendirilir.

Toplu / bayi kullanımı mümkün mü?

Evet. API, kendi müşteri panelinizi kurmak isteyen bayiler için tasarlanmıştır. Yüksek hacimli kullanım için destek ekibimizle iletişime geçin.

Hangi servis ve ülke kodlarını kullanmalıyım?

Servis ve ülke kodları standart SMS-Activate kısaltmalarıyla uyumludur (örn. Telegram için "tg", İngiltere için "44"). Güncel liste için Fiyatlar sayfasını inceleyin.