handler_api 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 sektörde yaygın handler_api protokolüyle uyumludur; bu protokol için yazılmış mevcut kütüphaneleriniz çoğu entegrasyonda yalnızca temel adres ve anahtar değişikliğiyle çalışır (bilinen birkaç fark vardır).

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.

handler_api Uyumu

getBalance, getNumber, getStatus ve setStatus aksiyonları handler_api protokolünün yaygın biçimini izler.

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.

handler_api protokolü için yazılmış mevcut kütüphanem çalışır mı?

Çoğu durumda evet. API'miz handler_api protokolüyle uyumludur; yalnızca temel adresi ve anahtarı Turonay'ın uç noktasıyla değiştirmeniz genellikle yeterlidir, bilinen birkaç fark vardır.

İ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ı handler_api protokolünde yaygın kısaltmalarla uyumludur (örn. Telegram için "tg", İngiltere için "44"). Güncel liste için Fiyatlar sayfasını inceleyin.