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.

Ücretsiz üye ol & key al Endpoint'lere bak

Canlı örnek

# Numara al
curl -X POST "https://uygunonay.com/api/v1/order" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"whatsapp","country":"ID"}'

Yanıt: phone + id · kod için status ucunu poll et

Saniyeler içindeSipariş anında döner, kod status ile izlenir

Güvenli anahtarHash'li saklama, hız limiti, IP allowlist

Bakiye kontrolüSipariş öncesi fiyat ve bakiye sorgula

Endpoint listesi

Tüm yollar base URL altına eklenir. Kimlik doğrulama zorunludur.

https://uygunonay.com/api/v1

Method	Path	Açıklama
GET	`/me`	Hesap özeti (bakiye, istatistik)
GET	`/balance`	Güncel bakiye
GET	`/services`	Aktif servis listesi ve başlangıç fiyatı
GET	`/countries`	Ülke listesi
GET	`/prices?service=whatsapp`	Ülke fiyatları ve stok
GET	`/orders`	Sipariş geçmişi (sayfalı)
POST	`/order`	Numara siparişi oluştur
GET	`/order/{id}`	Sipariş durumu + OTP kodu
POST	`/order/{id}/cancel`	İptal et ve iade al (yalnızca kod gelmeden)
POST	`/order/{id}/done`	Siparişi tamamla
POST	`/order/{id}/retry`	Aynı numaraya yeni kod iste (ücretsiz)

İptal ve iade kuralı

Numaraya bir kez kod ulaştığında sipariş iptal edilemez ve iade edilmez — /cancel çağrısı 409 döner. Bunun yerine /order/{id}/retry ile aynı numaraya ücretsiz yeni kod isteyebilirsiniz; süre sayacı sıfırlanır. Kod gelmeden kapanan siparişlerin ücreti (iptal veya süre dolması) otomatik iade edilir.

Kimlik doğrulama

Anahtarı yalnızca başlıkta gönderin; URL'e koymayın.

Authorization: Bearer YOUR_KEY
# veya
X-API-Key: YOUR_KEY

Kod örnekleri

Bakiye sorgula

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://uygunonay.com/api/v1/balance"

Numara al

curl -X POST "https://uygunonay.com/api/v1/order" \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"service":"telegram","country":"ID"}'

SMS bekle (poll)

curl -H "Authorization: Bearer YOUR_KEY" \
  "https://uygunonay.com/api/v1/order/123"

# status: waiting | received | cancelled | expired | done
# code:   OTP (status = received olduğunda)

PHP

$ch = curl_init("https://uygunonay.com/api/v1/order");
curl_setopt_array($ch, [
  CURLOPT_POST           => true,
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    "Authorization: Bearer YOUR_KEY",
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS     => json_encode([
    "service" => "whatsapp",
    "country" => "ID",
  ]),
]);
$order = json_decode(curl_exec($ch), true);

Hız limitleri ve hatalar

Durum	Kod	Anlamı
401	`invalid_key`	Anahtar yok, geçersiz veya iptal edilmiş
402	`insufficient_funds`	Bakiye siparişi karşılamıyor
403	`ip_not_allowed`	IP allowlist dışında istek
404	`order_not_found`	Sipariş bulunamadı veya size ait değil
409	`order_failed`	Stok yok ya da sağlayıcı reddetti
409	`cancel_failed`	Kod gelmiş sipariş iptal edilemez
409	`retry_failed`	Sağlayıcı yeniden kod göndermeyi desteklemiyor
422	`bad_service` / `bad_country`	Parametre geçersiz
429	`rate_limited`	Limit aşıldı — `Retry-After` başlığına bakın

Limitler: dakikada 120 genel istek, 30 sipariş. Durum yoklaması için 2–5 saniye aralık yeterlidir.

Hemen entegre et

Anahtarını al, ilk siparişini API ile ver.

Ücretsiz üye ol & key al