Kiralanacak numara talebi
getRentNumber yöntemi, SMS.online API'si aracılığıyla belirli bir süre için sanal numara kiralamak için kullanılır. Bu, belirli bir ülkede ve belirli bir hizmetten SMS almak için numara alma sürecini otomatikleştirir. Uzun süreli kullanım için mevcut numarayı seçmek üzere ülke, hizmet ve (isteğe bağlı olarak) operatör parametrelerini belirtebilirsiniz.
Bu yöntem, birkaç gün, hafta veya ay boyunca sürekli bir sanal numara gerektiğinde uygundur. Bu, uzun süreli SMS alma kanalı gerektiren sistemlere numaranın entegrasyonunu sağlar.
Başarılı bir talep, numara kimliği, kiralama süresi ve maliyet dahil olmak üzere numara bilgilerini içeren bir nesne döndürür. Bu yöntem, sürekli bir numaraya erişim gerektiren uzun etkileşim döngüsüne sahip uygulamalar ve hizmetler için özellikle faydalıdır.
İstek örneği:
Girdi verileri
| Parametre | Zorunlu | Not | Açıklama |
|---|---|---|---|
| Evet | Ayarlar bölümünde profilinize bakın API Anahtarı | API anahtarı, ücretli hizmetlere erişim sağlar | |
| Evet | getRentNumber | Metodun adı | |
| Evet | Sol menüdeki hizmetler listesine bakın | Alınması gereken numara için hizmet | |
| Evet | Sol menüdeki ülkeler listesine bakın | Alınması gereken numaranın ülkesi | |
| Hayır | Sol menüdeki operatörler listesine bakın | Alınması gereken numaranın mobil operatörü | |
| Hayır | 4, 8, 12, 24, 72, 168, 360, 720, 2160 | Kiralama süresi saat cinsinden | |
| Hayır | - | Webhook için bağlantı (varsayılan olarak dikkate alınmaz) |
Sunucu yanıtı
{
"status": "success",
"phone": {
"id": 1,
"endDate": "2025-05-10T12:34:56",
"number": "79999876543"
}
}Kod örneği
const api_key = "API_KEY"; # 'API_KEY'i gerçek API anahtarınızla değiştirin.const service = "SERVICE"; # 'SERVICE' kısmını hizmetin kimliği ile değiştirin. Tüm kimlikleri sol menüdeki belgelerden görebilirsiniz.const country = 1; # Gerekli ülkenin numarasını ekleyin. Tüm ülkelerin numaralarını sol menüdeki belgelerden görebilirsiniz.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentNumber&service=${service}&country=${country}`);# Belirtilen URL'ye GET isteği yapıyoruzconst data = await response.json();# Sunucudan gelen yanıtın içeriğini yazdırıyoruzconsole.log(data);} catch (err) {# Bir hata oluşursa, hata mesajını yazdırıyoruzconsole.error(err);}Olası hatalar
| Parametre | Açıklama |
|---|---|
| Geçersiz işlem | |
| Geçersiz API anahtarı | |
| İstekte hata | |
| Hesabın yasaklandığı süre | |
| Hesap aktif değil | |
| Geçersiz ülke adı | |
| Geçersiz hizmet adı | |
| Geçersiz zaman | |
| Bakiye bulunamadı | |
| Mevcut numara yok | |
| Hesap yasaklandı |