Kiralama durumunu değiştir
setRentStatus yöntemi, SMS.online API'si aracılığıyla kiralanmış sanal numaranın mevcut durumunu değiştirmek için kullanılır. Bu yöntem, numaranın kullanımını sonlandırma, kiralama süresini uzatma veya serbest bırakma gibi kiralama durumlarını otomatikleştirmeyi sağlar.
Bu yöntem, kiralanmış numaraların durumunu gerçek zamanlı olarak izlemek isteyen sistemler için tasarlanmıştır. Kiralamanın sona ermesini, uzatılmasını veya diğer durum değişikliklerini belirtmek için kullanılabilir, böylece bilgilerin güncel kalmasını sağlar.
Başarılı bir istek, kiralama durumunun değiştiğine dair onay içeren bir nesne döndürür ve güncellenmiş kiralama parametrelerini içerir. Bu yöntem, kiralanmış numaraların kullanım bilgilerini hızlı bir şekilde güncellemenin gerekli olduğu hizmetlerde özellikle faydalıdır.
İstek örneği:
Girdi verileri
Parametre | Zorunlu | Not | Açıklama |
---|---|---|---|
Evet | Ayarlar bölümünde profilinize bakın API Anahtarı | API anahtarı, ücretli hizmetlere erişim sağlar | |
Evet | setRentStatus | Metodun adı | |
Evet | Sayısal değer | Numara talep ederken alınan aktivasyon ID'si | |
Evet | Sayısal değer | Kiralama durumu |
Durum şu değerleri alabilir:
1 - Numara ile çalışmayı sonlandır
2 - Satın almayı iptal et
Sunucu yanıtı
{ "status": "success" }
Kod örneği
const api_key = "API_KEY"; # 'API_KEY'i gerçek API anahtarınızla değiştirin.const id = 1; # Numara talep ederken alınan aktivasyon ID'sini ekleyinconst status = 1; # Yukarıdaki tablodan yeni durumu ekleyintry {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setRentStatus&id=${id}&status=${status}`);# Belirtilen URL'ye GET isteği yapıyoruzconst data = await response.json();# Sunucudan gelen yanıtın içeriğini yazdırıyoruzconsole.log(data);} catch (err) {# Bir hata oluşursa, hata mesajını yazdırıyoruzconsole.error(err);}
Olası hatalar
Parametre | Açıklama |
---|---|
Geçersiz işlem | |
Geçersiz API anahtarı | |
İstekte hata | |
Hesabın yasaklandığı süre | |
Hesap aktif değil | |
Kiralama ID'si belirtilmemiş | |
Numara sizin tarafınızdan kiralanmamış (geçersiz kiralama ID'si) | |
Durum belirtilmemiş veya yanlış belirtilmiş | |
Kiralama iptal edilemez (20 dakikadan fazla) | |
Kiralama zaten tamamlandı | |
Kiralama zaten iptal edildi |