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

ParametreZorunluNotAçıklama
EvetAyarlar bölümünde profilinize bakın API AnahtarıAPI anahtarı, ücretli hizmetlere erişim sağlar
EvetsetRentStatusMetodun adı
EvetSayısal değerNumara talep ederken alınan aktivasyon ID'si
EvetSayısal değerKiralama durumu

Durum şu değerleri alabilir:

1 - Numara ile çalışmayı sonlandır

2 - Satın almayı iptal et

Sunucu yanıtı

JSON
{ 
  "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 ekleyin
const status = 1; # Yukarıdaki tablodan yeni durumu ekleyin
try {
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ıyoruz
const data = await response.json();
# Sunucudan gelen yanıtın içeriğini yazdırıyoruz
console.log(data);
} catch (err) {
# Bir hata oluşursa, hata mesajını yazdırıyoruz
console.error(err);
}

Olası hatalar

ParametreAçı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