API Dokümanı | SMS Onay

SMS Onay API'si, panelde yaptığınız tüm işlemleri (bakiye sorgulama, ülke/servis listeleme, numara alma, kod bekleme, iptal) programatik olarak yapmanıza olanak tanır. API anahtarınızı panelin Ayarlar › API bölümünden alırsınız.

Temel bilgiler

Base URL: https://api.smsonay.com/v1
Kimlik doğrulama: Authorization: Bearer <API_KEY>
Format: JSON · Zaman dilimi: UTC · Hız limiti: dakikada 120 istek

Uç noktalar

Yöntem	Yol	Açıklama
GET	`/balance`	Bakiye
GET	`/countries`	Ülke listesi (kod, ad, stok)
GET	`/services?country=DE`	Ülkeye göre servis ve fiyat
POST	`/numbers`	Numara al: `{"country":"DE","service":"whatsapp"}`
GET	`/numbers/<id>`	Durum ve gelen kod
POST	`/numbers/<id>/cancel`	İptal (kod gelmediyse iade)

Örnek: numara al ve kodu bekle

curl -X POST https://api.smsonay.com/v1/numbers \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"country":"DE","service":"telegram"}'

# yanıt
{"id":"n_8f2a","number":"+49151XXXXXXX","expires_in":600,"price":5.0}

curl https://api.smsonay.com/v1/numbers/n_8f2a -H "Authorization: Bearer $API_KEY"
{"id":"n_8f2a","status":"received","code":"48291"}

import requests, time
H = {"Authorization": "Bearer " + API_KEY}
n = requests.post("https://api.smsonay.com/v1/numbers", json={"country":"DE","service":"telegram"}, headers=H).json()
for _ in range(60):
    r = requests.get(f"https://api.smsonay.com/v1/numbers/{n['id']}", headers=H).json()
    if r["status"] == "received": print("Kod:", r["code"]); break
    time.sleep(5)

Hata kodları

401 geçersiz anahtar · 402 yetersiz bakiye · 404 numara bulunamadı · 409 stok yok · 429 hız limiti

Not: API erişimi hesap doğrulaması sonrası açılır. Sorularınız için info@smsonay.com.