POST /getNumber
Virtuelle Nummer für den angegebenen Dienst bestellen
Anfrage zur Bestellung einer Nummer für den Empfang von SMS vom angegebenen Dienst.
Diese Anfrage wird an Ihren Server gesendet, um eine Nummer für 15 Minuten mit den angegebenen Parametern zur Empfang einer SMS von einem Dienst zu bestellen.
Der Vorgang kann vorzeitig geschlossen werden (siehe FINISH_ACTIVATION).
WARNING
Ihr Server muss die Nummer mit den bestellten Parametern innerhalb von 10 Sekunden nach Erhalt der Anfrage ausgeben. Wenn nach Ablauf dieser Zeit die Nummer nicht ausgegeben wird, wird die aktuelle Anfrage automatisch abgebrochen.
WARNING
Wie in der Beschreibung erwähnt, müssen Sie eine Funktion zur Ausschließung von Nummernmasken implementieren. Der optionale Parameter exceptionPhoneSet kann ein Array mit einem Satz von Masken für Ausschlüsse enthalten. Wenn diese 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 dem übergebenen Wert [46950] keine Nummern Schwedens ausgegeben werden, die mit +46950* beginnen
%20%5BGET_NUMBER%5D.png)
WARNING
Nummern, die in einem Vorgang verwendet werden, können nicht in einem anderen verwendet werden, bis der vorherige Vorgang abgeschlossen ist (bis die Anfrage FINISH_ACTIVATION empfangen wurde).
%20%5BGET_NUMBER%5D.png)
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
Authorization* | string | Siehe Details hier Beispiel: Bearer apikey |
Content-Type* | string | Header Enumeration: application/json; charset=utf-8Beispiel:application/json; charset=utf-8 |
Anforderungs-Body
Anfragetext vom Onlinesim-Server
Content-Type:
application/jsonBodyobject
actionstringErforderlich
Name der Methode, in diesem Fall GET_NUMBER
Enumeration:
GET_NUMBERStandard:
GET_NUMBERBeispiel:
GET_NUMBERoperatorstringErforderlich
Name des Betreibers (für Beispiele siehe Liste der
Betreiber)
Beispiel:
anysumnumberErforderlich
Preis des Dienstes in Rubel (dieser Betrag wird auf Ihr Onlinesim-Partnerkonto gutgeschrieben, wenn der Vorgang erfolgreich abgeschlossen wird)
Beispiel:
40keystringErforderlich
API-Schlüssel Ihres Onlinesim-Partnerprofils
exceptionPhoneSetinteger[]
Liste der Ausnahmepräfixe für Nummernmasks, die NICHT bei der Nummernanfrage ausgegeben werden sollen. Format: Ländercode + darauf folgende Nummerziffern.
Antworten
200
Die Antwort Ihres Servers auf die Anfrage GET_NUMBER muss im folgenden Format sein:
Codebeispiele
Keine Codebeispiele verfügbar