SMS Onay API Entegrasyonu Nasıl Yapılır?

SMS onay API'si dört temel işlemden oluşur: numara al, kodu sorgula, bitir, iptal et.

1. Numara alma

GET /api.php?action=buy&service=wa&country=62

Yanıt, numarayı ve sipariş kimliğini döner. Bu kimliği saklamak zorunludur; kodu bu kimlikle sorgularsınız.

2. Kodu sorgulama (polling)

GET /api.php?action=order&id=12345

Yanıt durum alanı içerir: waiting, received, cancelled, expired. 3-5 saniyede bir sorgulama yeterlidir; daha sık istek göndermek rate limit riskini artırır.

3. Bitirme

GET /api.php?action=finish&id=12345

Kod alındıktan sonra siparişi kapatmak, sağlayıcı tarafında numarayı serbest bırakır ve maliyeti kesinleştirir.

4. İptal ve iade

GET /api.php?action=cancel&id=12345

Kod gelmeden iptal edilen siparişler otomatik iade edilir; bakiye anında panele yansır.

PHP örnek akış

$r = api('/api.php?action=buy&service=wa&country=62');
$id = $r['order']['id'];
for ($i = 0; $i < 40; $i++) {
    sleep(5);
    $s = api('/api.php?action=order&id=' . $id);
    if ($s['order']['status'] === 'received') { echo $s['order']['sms_code']; break; }
}

Entegrasyon önerileri

• Hata durumlarını (NO_NUMBERS, NO_BALANCE) ayrı ele alın ve otomatik ülke değiştirme mantığı ekleyin,
• Kod gelmezse iptal çağrısını mutlaka çalıştırın, aksi hâlde numara 20 dakika kilitli kalır,
• Log tutun: sipariş kimliği, hizmet, ülke, süre, sonuç. Hata ayıklamada tek dayanak bu olur,
• Eşzamanlı istek sayısını sağlayıcı limitine göre sınırlayın.