FAQAPI

Aktivasiya tarixini əldə etmək

getHistory metodu SMS.online API-si vasitəsilə hesabınıza bağlı bütün virtual nömrələrin aktivasiya tarixini əldə etmək üçün istifadə olunur. Bu, həyata keçirilmiş aktivasiyaların analizini və xidmət xərclərinin izlənməsini avtomatlaşdırmağa imkan tanıyır.

Metod, hər bir aktivasiya üçün tarix, telefon nömrəsi, alınan SMS kodları, qiymət və cari status daxil olmaqla ətraflı məlumat əldə etmək üçün nəzərdə tutulub. Bu, nömrələrin istifadəsini izləməyi və xərcləri nəzarət etməyi asanlaşdırır.

Uğurlu sorğu, aktivizasiya ilə bağlı detallı məlumatları olan strukturlaşdırılmış bir siyahı qaytarır: aktivizasiya üçün unikal identifikator, yaradılma tarixi, telefon nömrəsi, alınan SMS mesajlarının siyahısı, qiymət (aktiv olanlar üçün — 0) və aktivizasiya statusu. Metod analitika və xidmət xərclərinin idarə olunması sistemləri üçün uyğundur.

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əligetHistoryMetodun 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=getHistory`);
# 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