POST /getNumberRent
Mieten einer virtuellen Telefonnummer bestellen
Diese Anfrage erstellt einen neuen Mietvorgang, der es ermöglicht, eine Nummer für den Empfang von SMS von beliebigen Diensten und anderen Mobilnummern über einen längeren Zeitraum (von 1 Tag bis zu mehreren Monaten) zu verwenden.
DANGER
SCHLIESSEN SIE DEN VORGANG NICHT, bis Sie die Anfrage FINISH_ACTIVATION dafür erhalten haben.
TIP
Sie können denselben Endpunkt verwenden, den Sie für die Anfrage GET_NUMBER (v1) für den Dienst "SMS-Empfang" verwendet haben, oder einen neuen Endpunkt nur für Mietvorgänge erstellen. Bei der ersten Option müssen Sie ihn jedoch so modifizieren, dass Ihr Server die Anfrage zur Erstellung eines Mietvorgangs korrekt verarbeitet.
WARNING
Ihr Server muss die Nummer für die Miete mit den bestellten Parametern innerhalb von 10 Sekunden nach Erhalt der Anfrage ausgeben. Wenn nach Ablauf dieser Zeit keine Nummer ausgegeben wird, wird die aktuelle Anfrage automatisch abgebrochen.
Wenn die Nummer innerhalb von 20 Minuten nach Erstellung des Vorgangs keine SMS erhält, wird sie automatisch abgebrochen und die Nummer wird wieder für einen anderen Mietvorgang verfügbar. Wenn die Nummer dreimal keine SMS innerhalb von 20 Minuten nach Erstellung des Vorgangs erhalten kann, wird sie von unserem Server blockiert. Diese Bans werden automatisch alle 24 Stunden aufgehoben.
Die Miete kann vom Kunden verlängert werden, aber das Einkommen WIRD NUR BEI ABSCHLUSS DES VORGANGS GUTGESCHRIEBEN (bei Ablauf der Frist oder wenn der Kunde den Vorgang selbst schließt).
WARNING
Wir blockieren Nachrichten von Banken, Zahlungssystemen und Kreditinstituten, um Partner vor möglichen rechtlichen Konsequenzen zu schützen, die bei der Verwendung solcher Dienste durch Kunden entstehen können. Gleichzeitig unterstützt die Miete nicht die Möglichkeit, Dienste zur Ausschlussliste hinzuzufügen, da wir im Voraus nicht wissen, welche Dienste von Kunden verwendet werden können. Bitte beachten Sie, dass SMS VON DIENSTEN, DIE SIE ZUR AUSSCHLUSSLISTE FÜR DEN DIENST "SMS-EMPFANG" HINZUGEFÜGT HABEN, BEI DER MIETE AN KUNDEN ÜBERMITTELT WERDEN.
WARNING
Genau wie beim Empfang müssen Sie für die Miete eine Funktion zum Ausschließen von Nummernmasks implementieren. Der optionale Parameter exceptionPhoneSet kann ein Array mit einem Satz von Masken für Ausnahmen enthalten. Wenn sie vorhanden sind (wenn der Parameter übergeben wird), muss Ihr Server Nummern mit Masken, die in diesem Satz übereinstimmen, von der Ausgabe ausschließen. Zum Beispiel sollten bei übergebenem Wert [46950] für die Miete keine Nummern Schwedens ausgegeben werden, die mit +46950* beginnen
%20%5BGET_NUMBER%5D.png)
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
Authorization* | string | Siehe Details hier Beispiel: Bearer apikey |
Anforderungs-Body
Anfragetext vom Onlinesim-Server für den Mietvorgang
Content-Type:
application/jsonBodyobject
actionstringErforderlich
Name der Methode, in diesem Fall GET_NUMBER
Enumeration:
GET_NUMBERStandard:
GET_NUMBERBeispiel:
GET_NUMBERkeystringErforderlich
API-Schlüssel Ihres Onlinesim-Partnerprofils
operatorstringErforderlich
Name des Operators (für Beispiele siehe Liste der
Operatoren)
Beispiel:
anyservicestringErforderlich
Name des Dienstes. Für die Miete immer rent
Enumeration:
rentBeispiel:
rentsumnumberErforderlich
Anfangsmietkosten in Rubel (dieser Betrag wird auf Ihr Onlinesim-Partnerkonto gutgeschrieben, nachdem der Mietvorgang erfolgreich abgeschlossen wurde)
Beispiel:
320exceptionPhoneSetinteger[]
Liste der Ausschlusspräfixe für Nummernmasken, die NICHT AUSGEGEBEN WERDEN SOLLTEN bei der Nummernanfrage.
Format: Ländercode + darauf folgende Nummerziffern.
Zum Beispiel sollten bei dem übergebenen Wert 46950 keine Nummern Schwedens ausgegeben werden, die mit +46950* beginnen
Antworten
200
“Die Antwort Ihres Servers auf die Anfrage GET_NUMBER muss
im folgenden Format sein:”
Codebeispiele
Keine Codebeispiele verfügbar