OnaySIM Geliştirici & Bayi API Dokümantasyonu
Web panellerinize, SMS satış sitelerinize, Telegram/WhatsApp botlarınıza veya özel yazılımlarınıza OnaySIM altyapısını saniyeler içinde bağlayın. Evrensel Standart SMS Protokolü ve REST mimarisiyle %100 uyumludur.
API anahtarınızı görmek ve test istekleri atmak için giriş yapmalısınız.
Giriş Yap / Kayıt OlAPI Endpoint Adresleri
Tüm GET ve POST isteklerinizi aşağıdaki adreslere gönderebilirsiniz:
Web Panellerine ve Bayilik Sistemlerine Bağlama
Yazılım geliştirmeden web panellerinize ve bayilik altyapılarınıza OnaySIM'i 1 dakikada entegre edin:
- Panelinizde Sağlayıcı / Provider Ekle sayfasına gidin.
- Protokol veya modül türü olarak Standart SMS API Protokolü seçin.
- API URL kısmına
https://onaysim.com/api/v1/handler.phpyazın. - API Key kısmına profilinizdeki size özel OnaySIM anahtarınızı girip kaydedin.
- Tüm ülkeler, servisler ve toptan bayi fiyatları anında otomatik listelenecektir.
Hızlı Başlangıç & Kod Örnekleri
Favori programlama dilinizi seçerek test isteklerini hemen çalıştırabilirsiniz.
# 1. Bakiye Sorgulama
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getBalance"
# 2. WhatsApp (Türkiye) Numarası Satın Alma
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getNumber&service=wa&country=62"
# 3. Gelen SMS Kodunu Kontrol Etme (activation_id ile)
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=getStatus&id=123456"
# 4. Numarayı İptal Etme & Bakiye İadesi Alma
curl -X GET "https://onaysim.com/api/v1/handler.php?api_key=YOUR_API_KEY&action=setStatus&id=123456&status=8"
API Parametre & Aksiyon Referansı
Tüm uç noktalar, parametreler ve standart dönüş kodları.
Zorunlu Parametreler: api_key, action=getBalance
Opsiyonel: format=json
Dönüş: ACCESS_BALANCE:15.50 (JSON ise {"status":"ACCESS_BALANCE","balance":15.50,"currency":"USDT"})
Zorunlu Parametreler: api_key, action=getPrices
Opsiyonel Filtreler: country=62, service=wa
Dönüş: JSON formatında ülke ve servis bazlı fiyat ve stok matrisi.
Parametreler:
service (Örn: wa, tg, go, ig, tw, dr),
country (Örn: 62=Türkiye, 12=ABD, 16=İngiltere),
maxPrice (İsteğe bağlı tavan fiyat)
Başarılı Dönüş: ACCESS_NUMBER:AKTIVASYON_ID:TELEFON_NUMARASI
Hata Kodları: NO_BALANCE (Yetersiz bakiye), NO_NUMBERS (Stokta numara yok), BAD_SERVICE (Geçersiz servis)
Parametreler: id (getNumber ile dönen aktivasyon ID)
Olası Dönüşler:
STATUS_WAIT_CODE: Kod henüz gelmedi, bekleniyor (3-5 saniye aralıklarla tekrar sorgulanmalıdır).STATUS_OK:123456: SMS kodu başarıyla ulaştı! İki noktadan sonraki kısım gelen SMS kodudur.STATUS_CANCEL: Numara iptal edildi veya 20 dakikalık süre dolduğu için otomatik kapatıldı ve bakiye iade edildi.
Parametreler: id (Aktivasyon ID), status (Durum kodu)
Status Kodları:
status=8: Numarayı iptal eder, sağlayıcıdan düşer ve harcanan tutarı anında kullanıcı bakiyesine %100 iade eder (ACCESS_CANCEL).status=6: Aktivasyonu başarıyla tamamlandı olarak işaretler (ACCESS_ACTIVATION).status=1: SMS'in telefona gönderildiğini ve hazır olunduğunu bildirir (ACCESS_READY).status=3: İkinci bir SMS kodu talep eder (ACCESS_RETRY_GET).
Standart Hata Yanıtları
| Hata Kodu | Açıklama | Çözüm Yolu |
|---|---|---|
| BAD_KEY | Geçersiz veya eksik API anahtarı. | Profilinizdeki güncel API anahtarınızı kontrol edin. |
| ERROR_IP_NOT_ALLOWED | İstek atan sunucu IP adresi beyaz listede yer almıyor. | Profil sayfasından IP kısıtlamasını güncelleyin veya kaldırın. |
| NO_BALANCE | Kullanıcı bakiyesi bu numara alımı için yetersiz. | USDT TRC-20 ile bakiye yükleyin. |
| NO_NUMBERS | Seçilen ülke ve serviste anlık hat stoğu tükenmiş. | Farklı bir ülke seçin veya 1-2 dakika sonra tekrar deneyin. |
| BAD_SERVICE | Geçersiz servis kodu belirtilmiş. | Desteklenen servis kodlarını kullanın (wa, tg, go vb.). |
| NO_ACTIVATION | Belirtilen ID'ye ait aktivasyon kaydı bulunamadı. | Sipariş ID değerinin size ait olduğunu doğrulayın. |