İcarə statusunu dəyişdir

setRentStatus metodu SMS.online API vasitəsilə icarəyə götürülmüş virtual nömrənin cari statusunu dəyişdirmək üçün istifadə olunur. Bu metod, nömrənin istifadəsinin başa çatması, icarə müddətinin uzadılması və ya onun boşaldılması da daxil olmaqla, icarə statuslarının idarə edilməsini avtomatlaşdırmağa imkan verir.

Bu metod, icarəyə götürülmüş nömrələrin statusunu real vaxtda operativ şəkildə izləmək tələb edən sistemlər üçün nəzərdə tutulub. Onun köməyi ilə icarənin başa çatması, uzadılması və ya digər status dəyişiklikləri göstərilə bilər, məlumatların aktual olmasını təmin edir.

Uğurlu sorğu, icarə statusunun dəyişdirilməsi ilə bağlı təsdiq edən obyekt qaytarır, yenilənmiş icarə parametrlərini də daxil edir. Bu metod, icarəyə götürülmüş nömrələrin istifadəsi ilə bağlı məlumatların sürətli yenilənməsini tələb edən xidmətlərdə xüsusilə faydalıdır.

Sorğu nümunəsi:

Giriş məlumatları

Məcburi	Qeydlər	Təsvir
Bəli	Profilinizdə API Açarı bölməsində baxın	API açarı ödənilən xidmətlərə giriş təmin edir
Bəli	setRentStatus	Metodun adı
Bəli	Rəqəmsal dəyər	Nömrə sorğusu zamanı alınan aktivləşdirmə ID-si
Bəli	Rəqəmsal dəyər	İcarənin statusu

Status aşağıdakı dəyərləri qəbul edə bilər:

1 - Nömrə ilə işin başa çatması

2 - Alışın ləğvi

Serverin cavabı

JSON

{ 
  "status": "success"
}

Kod nümunəsi

const api_key = "API_KEY"; # 'API_KEY' yerinə sizin real API açarınızı qoyun.
const id = 1; # Nömrə sorğusu zamanı alınan aktivləşdirmə ID-sini daxil edin
const status = 1; # Yuxarıdakı cədvəldən yeni statusu daxil edin
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=setRentStatus&id=${id}&status=${status}`);
# Göstərilən URL-ə GET sorğusu icra edirik
const data = await response.json();
# Serverdən alınan cavabın məzmununu çap edirik
console.log(data);
} catch (err) {
# Xəta baş verərsə, xəta mesajını çap edirik
console.error(err);
}

Mümkün xətalar

Parametr	Təsvir
	Yanlış hərəkət
	Yanlış API açarı
	Sorğuda xəta
	Hesabın bloklandığı vaxt
	Hesab aktiv deyil
	İcarə ID-si göstərilməyib
	Nömrə sizin tərəfinizdən icarəyə götürülməyib (yanlış icarə ID-si)
	Status yoxdur və ya yanlış göstərilib
	İcarəni ləğv etmək mümkün deyil (20 dəqiqədən çox)
	İcarə artıq başa çatıb
	İcarə artıq ləğv edilib