Ana Sayfa /
API
REST JSON API
SMS onayı API ile otomatikleştirin
Bot, panel veya kendi yazılımınız için SMS onay REST API. Numara alın, SMS onay kodunu okuyun, iptal edin; hepsi birkaç satır kodla ve saniyeler içinde.
Saniyeler içinde SMS onay
Sipariş anında numara döner; SMS onay kodu status endpoint'i 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 ve fiyat kontrolü
Sipariş öncesi bakiye ve ülke fiyatını sorgulayın; yetersiz bakiyede net hata alın, SMS gelmezse iade otomatiktir.
4 adımda SMS onay API
Üyelik, API key, sipariş ve SMS onay kodu; 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://www.smsonay.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://www.smsonay.com/api/v1/balance"
Numara al
curl -X POST "https://www.smsonay.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://www.smsonay.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.