SMS Onay API: Sanal Numara Entegrasyonu
Getonay API'si, panelde yaptığınız her işlemi programatik olarak yapmanızı sağlar: fiyat sorgulama, numara tahsisi, SMS okuma, iptal ve bakiye kontrolü. REST tabanlıdır, JSON döner ve tek bir bearer anahtarıyla çalışır.
API Anahtarı AlKimlik doğrulama
Her istek Authorization: Bearer <api_key> başlığı taşır. Anahtar hesap panelinden oluşturulur, istediğiniz zaman iptal edilebilir ve yalnızca kendi bakiyeniz üzerinde işlem yapar. Anahtarı istemci tarafı koda gömmeyin.
Uç noktalar
/api/v1/prices?service=whatsapp&country=turkeyServis ve ülke bazında güncel fiyat ve stok listesini döner.
curl -H "Authorization: Bearer $GETONAY_API_KEY" \
"https://getonay.com/api/v1/prices?service=whatsapp&country=turkey"/api/v1/numbersYeni numara tahsis eder. Numara teslim edilmeden bakiyeden tahsilat yapılmaz.
curl -X POST https://getonay.com/api/v1/numbers \
-H "Authorization: Bearer $GETONAY_API_KEY" \
-H "Content-Type: application/json" \
-d '{"service":"whatsapp","country":"turkey"}'/api/v1/numbers/{id}Siparişin durumunu ve gelen SMS metnini döner.
const res = await fetch(`https://getonay.com/api/v1/numbers/${id}`, {
headers: { Authorization: `Bearer ${process.env.GETONAY_API_KEY}` },
});
const { status, phone, sms } = await res.json();/api/v1/numbers/{id}/cancelKod gelmeyen siparişi iptal eder; tutar anında bakiyeye iade edilir.
curl -X POST https://getonay.com/api/v1/numbers/ord_123/cancel \
-H "Authorization: Bearer $GETONAY_API_KEY"/api/v1/balanceHesap bakiyesini TRY cinsinden döner.
curl -H "Authorization: Bearer $GETONAY_API_KEY" \
https://getonay.com/api/v1/balanceSipariş yaşam döngüsü
Sipariş pending durumunda başlar; numara tahsis edildiğinde active, SMS düştüğünde completed, süre dolduğunda veya iptal edildiğinde cancelled olur. İptal edilen siparişlerde tutar aynı anda bakiyeye iade edilir.
Durum sorgulamasını 3-5 saniyelik aralıklarla yapın. Daha sık sorgulama hız sınırına takılır ve 429 döner.
Hata kodları
- 401 — Geçersiz veya iptal edilmiş API anahtarı.
- 402 — Yetersiz bakiye; sipariş oluşturulmadı.
- 404 — Sipariş bulunamadı ya da başka bir hesaba ait.
- 409 — İstenen servis/ülke kombinasyonunda stok yok.
- 429 — Hız sınırı aşıldı; sorgu aralığını artırın.
Kimler için uygun?
Toplu doğrulama akışı kuran ajanslar, test otomasyonu yazan QA ekipleri ve kendi panelini geliştiren bayiler API üzerinden çalışır. Fiyatlandırma panelle aynıdır; API kullanımı için ek abonelik ücreti alınmaz. Güncel birim fiyatları fiyat listesinde görebilirsiniz.