Geliştiriciler için
SMS onay akışını API ile uygulamanıza bağlayın
Servis ve ülke seçeneklerini listeleyin, numara talep edin, SMS kodunun durumunu izleyin ve sipariş yaşam döngüsünü kendi yazılımınızdan yönetin.
GET /api/v1/handler.php
?key=YOUR_API_KEY
&action=getServices
&country=turkeyKatalog sorguları
Servisleri, ülkeleri ve uygun operatörleri güncel stok bilgileriyle sorgulayın.
Numara ve sipariş
Servis kodu ve ülke seçimine göre numara talep edip sipariş kimliği alın.
Durum takibi
Sipariş durumunu ve ulaşan SMS kodunu uygulamanızdan düzenli olarak kontrol edin.
Desteklenen temel işlemler
| İşlem | Action | Amaç |
|---|---|---|
| Bakiye sorgula | getBalance | Kullanılabilir hesap bakiyesini döndürür. |
| Servisleri listele | getServices | Servis, fiyat ve stok seçeneklerini listeler. |
| Ülkeleri listele | getCountries | Mevcut ülke seçeneklerini döndürür. |
| Operatörleri listele | getOperators | Servis ve ülke için operatörleri listeler. |
| Numara al | getNumber | Uygun numara ve sipariş kimliği oluşturur. |
| Durumu kontrol et | getStatus | Sipariş durumunu ve varsa SMS kodunu döndürür. |
| Siparişi iptal et | cancelOrder | Uygun sipariş için iptal akışını başlatır. |
Güvenli entegrasyon notları
- API anahtarınızı tarayıcı kodunda veya herkese açık depolarda paylaşmayın.
- İstekleri kendi sunucunuzdan gönderin ve anahtarı ortam değişkeninde saklayın.
- Durum sorgularında makul aralıklar kullanın; gereksiz yoğun istek oluşturmayın.
- Gerçek endpoint ve kişisel API anahtarınız, giriş sonrasında dokümantasyon ekranında gösterilir.
Örnek JSON API isteği
Aşağıdaki örnek yalnızca istek yapısını gösterir. YOUR_API_KEY alanını hesabınızda oluşturulan anahtarla değiştirin.
curl "https://onayplus.com/api/v1/handler.php?key=YOUR_API_KEY&action=getNumber&service_code=wa&country=tr"Başarılı yanıtta sipariş kimliği, numara, fiyat ve kalan bakiye JSON biçiminde döner. Tam yanıt alanları ve durum değerleri için giriş yaptıktan sonra hesaba özel API dokümantasyonunu kullanın.