FAQAPI

İcarə tarixçəsinin əldə edilməsi

getRentHistory metodu SMS.online API-si vasitəsilə hesabınıza bağlı olan bütün icarəyə götürülmüş virtual nömrələrin tam siyahısını əldə etmək üçün istifadə olunur. Bu, uzunmüddətli icarə zamanı nömrələrin istifadəsini avtomatlaşdırmağa və uzadılma xərclərini izləməyə imkan tanıyır.

Metod, icarə ilə bağlı ətraflı məlumat əldə etməyə imkan verir, o cümlədən başlama tarixi, müddət, telefon nömrəsi, icarə statusu və uzadılma dəyəri. Bu, cari və tamamlanmış icarələri izləməyə, eləcə də nömrələrin uzunmüddətli istifadəsi üçün xərcləri qiymətləndirməyə kömək edir.

Uğurlu sorğu, icarə olunan bütün nömrələrin siyahısını, o cümlədən unikal icarə identifikatorunu, başlama tarixini, müddəti, telefon nömrəsini, cari statusu və icarə məbləğini əhatə edən strukturlaşdırılmış obyekt qaytarır. Bu metod analitika və icarə xərclərinin monitorinqi üçün optimaldır.

Sorğu nümunəsi:

Giriş məlumatları

ParametrMəcburiQeydlərTəsvir
BəliProfilinizdə API Açarı bölməsində baxınAPI açarı ödənilən xidmətlərə giriş təmin edir
BəligetRentHistoryMetodun adı
XeyrUnix Timestamp formatında vaxt damğasıAktivləşdirmələri götürmək üçün tarix (30 gün ilə məhdudlaşır)
XeyrUnix Timestamp formatında vaxt damğasıAktivləşdirmələri götürmək üçün tarix (30 gün ilə məhdudlaşır)
XeyrRəqəmsal dəyərCavabda qaytarılan ilk elementin ofseti (default 0)
XeyrRəqəmsal dəyərCavabda qaytarılan elementlərin sayı (default 50, maksimum 100)

Serverin cavabı

JSON
[
  {
    "id": 635468024,
    "date": "2022-11-12 15:58:39",
    "phone": "79918529716",
    "sms": "["Your sms code"]",
    "cost": 100
    "status": "4"
  }
]

Kod nümunəsi

const api_key = "API_KEY"; # 'API_KEY' yerinə sizin real API açarınızı qoyun.
try {
const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentHistory`);
# 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

ParametrTəsvir
Yanlış hərəkət
Yanlış API açarı
Sorğuda xəta
Hesabın bloklandığı vaxt
Hesab aktiv deyil
Yanlış tarix