Ana Sayfa / API
REST JSON API

SMS onayını API ile otomatikleştir

Bot, panel veya kendi yazılımın için REST JSON API. Numara al, SMS kodunu oku, iptal et — hepsi birkaç satır kodla.

Saniyeler içinde Sipariş anında döner; SMS kodu status ile takip edilir.
Güvenli key Header-only auth, hash’li saklama, rate limit ve isteğe bağlı IP allowlist.
JSON yanıtlar Modern REST. Curl, Node, Python veya kendi dilinde kolay entegrasyon.
Bakiye kontrolü Sipariş öncesi bakiye ve fiyat sorgula; yetersiz bakiyede net hata al.

4 adımda başla

Üyelik, key, sipariş ve SMS — entegrasyon bu kadar.

1
Hesap aç Ücretsiz kaydol, bakiyeni yükle.
2
API key al Profil sayfasından key oluştur.
3
Sipariş ver POST /order ile servis + ülke gönder.
4
Kodu oku GET /order/{id} ile SMS kodunu al.

Endpoint listesi

Tüm yollar base URL altına eklenir. Auth zorunludur.

https://smsonayli.com/api/v1
Method Path Açıklama
GET /me Hesap özeti
GET /balance Güncel bakiye
GET /services Aktif servis listesi
GET /prices?service=wa Ülke fiyatları / stok
POST /order Numara siparişi oluştur
GET /order/{id} Sipariş durumu + OTP
POST /order/{id}/cancel İptal ve iade
POST /order/{id}/done Siparişi tamamla

Kod örnekleri

Hemen kopyala, YOUR_KEY yerine kendi key’ini yaz.

Bakiye sorgula
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://smsonayli.com/api/v1/balance"
Numara al
curl -X POST "https://smsonayli.com/api/v1/order" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"wa","country":"62"}'
SMS bekle
curl -H "Authorization: Bearer YOUR_KEY" \
  "https://smsonayli.com/api/v1/order/123"

# status: waiting | received | cancelled | expired | done
# code: OTP (when received)

API hakkında SSS

En çok sorulan entegrasyon soruları.

Üye olduktan sonra Profil sayfasından “API key oluştur” ile key üretirsin. Key yalnızca oluşturulurken bir kez tam görünür.
REST JSON olduğu için her dil çalışır: PHP, Python, Node.js, Go, C#… Curl örnekleri dokümantasyonda.
Paneldeki gibi süre dolunca veya iptalde başarıyla iade uygulanır. Status “expired” / “cancelled” döner.
Evet: dakikada 120 genel istek, 30 sipariş. Aşımda HTTP 429 ve X-RateLimit başlıkları döner. Status poll için 2–5 sn yeter.
Key hash’lenerek saklanır; yalnızca header ile gönderilir. Profil’den IP allowlist tanımlayabilir, sızıntıda yenileyebilirsin.
Entegrasyon için hazır mısın?

Üye ol, API key oluştur ve ilk numaranı birkaç satırda al.

Ücretsiz üye ol & key al İletişim