Skip to content

GET /stubs/handler_api.php?action=getNumber

Kauf einer virtuellen Nummer für den ausgewählten Dienst

Diese Anfrage ermöglicht es Ihnen, eine virtuelle Nummer eines bestimmten Landes zum Empfang von SMS vom von Ihnen ausgewählten Dienst (Website, mobile Anwendung usw.) zu bestellen. Dies ist der Hauptdienst, der von Onlinesim bereitgestellt wird: Sie können virtuelle Nummern verwenden, um Verifizierungscodes oder andere Informationen zu empfangen, die in SMS-Nachrichten enthalten sind.

WARNING

Bitte beachten Sie, dass die Nummer für 15 Minuten ausgegeben wird (die endgültige Frist hängt vom Dienst und Land ab und kann vom angegebenen Wert abweichen) und nach dem Schließen des Vorgangs nicht mehr verfügbar ist.

Sicherheit

  • api_key
  • BearerAuth
  • OAuth2 (Berechtigungen: sms-scope)
    • sms-scope: grants access to manage numbers for the SMS receiving service from Onlinesim

Parameter

NameTypBeschreibung
action*string

Name der Methode, in diesem Fall getNumber

Enumeration:getNumberStandard:getNumber
service*string

Service-Slug (kurzer Dienstname, erforderlich für die Bestellung einer Nummer, siehe getNumbersStatus)

Beispiel:3223
country*integer

Länder-ID (siehe Anfrage getCountries)

Standard:7Beispiel:46
phoneExceptiononeOf

Array für Maskenausnahmen (einschließlich der Ländervorwahl)

Zum Beispiel: mit dem Wert [911,912123] werden keine Nummern aus Indien ausgegeben, die mit 911* und 912123* beginnen

Beispiel:908

Antworten

200

Erfolgreiche Antwort vom Server auf die Anfrage getNumber: gibt entweder die Vorgangs-ID zurück und gibt eine virtuelle Nummer zum Empfang von SMS vom angegebenen Dienst aus oder wirft eine Ausnahme.

Codebeispiele