İcarə üçün nömrə sorğusu
getRentNumber metodu SMS.online API vasitəsilə müəyyən bir müddətə virtual nömrə icarəyə götürmək üçün istifadə olunur. Bu, müəyyən bir ölkədə və göstərilən xidmətdən SMS qəbul etmək üçün nömrə əldə etmə prosesini avtomatlaşdırmağa imkan tanıyır. Siz ölkə, xidmət və (istəyə bağlı) operator parametrlərini göstərə bilərsiniz ki, uzunmüddətli istifadə üçün mövcud nömrə seçilsin.
Bu metod, bir neçə gün, həftə və ya ay ərzində daimi virtual nömrəyə ehtiyac duyulduqda uyğundur. Bu, SMS qəbul etmək üçün sabit bir kanalın lazım olduğu sistemlərə nömrənin inteqrasiyasını asanlaşdırır.
Uğurlu sorğu, nömrənin identifikatoru, icarə müddəti və qiyməti daxil olmaqla, nömrə haqqında məlumatı əks etdirən bir obyekt qaytarır. Bu metod, bir nömrəyə daimi girişin lazım olduğu uzunmüddətli qarşılıqlı əlaqə dövrü olan tətbiqlər və xidmətlər üçün xüsusilə faydalıdır.
Sorğu nümunəsi:
Giriş məlumatları
| Parametr | 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 | getRentNumber | Metodun adı | |
| Bəli | Sol menyuda xidmətlər siyahısına baxın | Alınması lazım olan nömrənin xidməti | |
| Bəli | Sol menyuda ölkələr siyahısına baxın | Alınması lazım olan nömrənin ölkəsi | |
| Xeyr | Sol menyuda operatorlar siyahısına baxın | Alınması lazım olan nömrənin mobil operatoru | |
| Xeyr | 4, 8, 12, 24, 72, 168, 360, 720, 2160 | İcarə müddəti saatlarla | |
| Xeyr | - | Webhook üçün link (default olaraq nəzərə alınmır) |
Serverin cavabı
{
"status": "success",
"phone": {
"id": 1,
"endDate": "2025-05-10T12:34:56",
"number": "79999876543"
}
}Kod nümunəsi
const api_key = "API_KEY"; # 'API_KEY' yerinə sizin real API açarınızı qoyun.const service = "SERVICE"; # 'SERVICE' yerinə xidmətin identifikatorunu qoyun. Bütün identifikatorları sol menyudakı sənəddən görə bilərsiniz.const country = 1; # Lazım olan ölkənin nömrəsini daxil edin. Bütün ölkələrin nömrələrini sol menyudakı sənəddən görə bilərsiniz.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentNumber&service=${service}&country=${country}`);# Göstərilən URL-ə GET sorğusu icra edirikconst data = await response.json();# Serverdən alınan cavabın məzmununu çap edirikconsole.log(data);} catch (err) {# Xəta baş verərsə, xəta mesajını çap edirikconsole.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 | |
| Yanlış ölkə adı | |
| Yanlış xidmət adı | |
| Yanlış vaxt | |
| Balans tapılmadı | |
| Mövcud nömrələr yoxdur | |
| Hesab bloklanıb |