post{yourserver}/getNumberRent

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.

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).

Parameter

header1

Name	Typ	Beschreibung
`Authorization`*	`string`	Siehe Details hier

Anforderungs-Body

Anfragetext vom Onlinesim-Server für den Mietvorgang

Content-Typeapplication/json

Schema

Bodyobject

actionstringErforderlich

Name der Methode, in diesem Fall GET_NUMBER

Enumeration:GET_NUMBERStandard:GET_NUMBER

keystringErforderlich

API-Schlüssel Ihres Onlinesim-Partnerprofils

countrystringErforderlich

Name des Landes, enum (siehe Liste der Länder)

operatorstringErforderlich

Name des Operators (für Beispiele siehe Liste der Operatoren)

servicestringErforderlich

Name des Dienstes. Für die Miete immer rent

Enumeration:rent

sumnumberErforderlich

Anfangsmietkosten in Rubel (dieser Betrag wird auf Ihr Onlinesim-Partnerkonto gutgeschrieben, nachdem der Mietvorgang erfolgreich abgeschlossen wurde)

exceptionPhoneSetinteger[]

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

itemsinteger

Beispiele

Example payload of Onlinesim server GET_NUMBER request (for rent)

{
  "action": "GET_NUMBER",
  "key": "apikey",
  "country": "germany",
  "operator": "any",
  "service": "rent",
  "sum": 400
}

Antworten

200

"Die Antwort Ihres Servers auf die Anfrage GET_NUMBER muss im folgenden Format sein:"

Content-Typeapplication/json

Header

Name	Typ	Beschreibung
`Content-Type`	`string`	Header `Content type` und Codierung

Schema

Responseobject

numberintegerErforderlich

Telefonnummer im internationalen Format gemäß den in der Anfrage angegebenen Parametern

activationIdintegerErforderlich

Vorgangs-ID (wird von Ihrem Server zugewiesen)

≥ 1

statusstringErforderlich

Status der Anfrageausführung (SUCCESS - bei erfolgreicher Nummernausgabe, NO_NUMBERS - wenn keine verfügbaren Nummern vorhanden sind, ERROR - bei anderen Fehlern)

Enumeration:SUCCESSNO_NUMBERSERROR

Beispiele

Successful response example from your server

{
  "number": 79281234567,
  "activationId": 355,
  "status": "SUCCESS"
}

No available numbers response example from your server

{
  "number": null,
  "activationId": null,
  "status": "NO_NUMBERS"
}

Response example from your server in case of other types of errors

{
  "number": null,
  "activationId": null,
  "status": "ERROR"
}

Codebeispiele

Beispiele werden generiert...