Miete eines virtuellen Nummer
Die Methode getRentNumber wird verwendet, um eine virtuelle Nummer für einen bestimmten Zeitraum über die API von SMS.online zu mieten. Sie ermöglicht die Automatisierung des Prozesses zur Beschaffung einer Nummer für den Empfang von SMS in einem bestimmten Land und von einem angegebenen Dienst. Sie können die Parameter für das Land, den Dienst und (optional) den Anbieter angeben, um eine verfügbare Nummer für die langfristige Nutzung auszuwählen.
Die Methode eignet sich für Situationen, in denen eine permanente virtuelle Nummer für mehrere Tage, Wochen oder Monate benötigt wird. Dies ermöglicht die Integration der Nummer in Systeme, die einen stabilen Kanal für den Empfang von SMS über einen längeren Zeitraum erfordern.
Eine erfolgreiche Anfrage gibt ein Objekt mit Informationen zur Nummer zurück, einschließlich ihrer ID, Mietdauer und Kosten. Die Methode ist besonders nützlich für Anwendungen und Dienste mit langen Interaktionszyklen, bei denen ein kontinuierlicher Zugang zu einer Nummer erforderlich ist.
Beispielanfrage:
Eingabedaten
| Parameter | Erforderlich | Hinweis | Beschreibung |
|---|---|---|---|
| Ja | Siehe im Profil in den Einstellungen API Schlüssel | Der API-Schlüssel gewährt Zugriff auf kostenpflichtige Dienste | |
| Ja | getRentNumber | Name der Methode | |
| Ja | Siehe Liste der Dienste im linken Menü | Dienst, für den eine Nummer benötigt wird | |
| Ja | Siehe Liste der Länder im linken Menü | Land, dessen Nummer benötigt wird | |
| Nein | Siehe Liste der Betreiber im linken Menü | Mobilfunkanbieter, dessen Nummer benötigt wird | |
| Nein | 4, 8, 12, 24, 72, 168, 360, 720, 2160 | Mietzeit in Stunden | |
| Nein | - | Webhook-Link (Standardmäßig nicht berücksichtigt) |
Serverantwort
{
"status": "success",
"phone": {
"id": 1,
"endDate": "2025-05-10T12:34:56",
"number": "79999876543"
}
}Beispielcode
const api_key = "API_KEY"; # Ersetzen Sie 'API_KEY' durch Ihren tatsächlichen API-Schlüssel.const service = "SERVICE"; # Ersetzen Sie 'SERVICE' durch die Dienst-ID. Alle IDs können in der Dokumentation im linken Menü eingesehen werden.const country = 1; # Geben Sie die Nummer des gewünschten Landes ein. Nummern aller Länder können in der Dokumentation im linken Menü eingesehen werden.try {const response = await fetch(`https://api.sms.onlinestubs/handler_api.php?api_key=${api_key}&action=getRentNumber&service=${service}&country=${country}`);# Führen Sie eine GET-Anfrage an die angegebene URL ausconst data = await response.json();# Geben Sie den Inhalt der Serverantwort ausconsole.log(data);} catch (err) {# Wenn ein Fehler aufgetreten ist, geben Sie die Fehlermeldung ausconsole.error(err);}Mögliche Fehler
| Parameter | Beschreibung |
|---|---|
| Ungültige Aktion | |
| Ungültiger API-Schlüssel | |
| Fehler in der Anfrage | |
| Zeit, für die das Konto gesperrt ist | |
| Konto nicht aktiv | |
| Ungültiger Ländername | |
| Ungültiger Dienstname | |
| Ungültige Zeit | |
| Kein Kontostand gefunden | |
| Keine verfügbaren Nummern | |
| Konto gesperrt |