gethttps://onlinesim.io/api/rent/getRentNum.php

GET /api/rent/getRentNum.php

Virtuelle Telefonnummer für die Miete kaufen

Diese Anfrage ermöglicht es Ihnen, eine Nummer eines bestimmten Landes zum Empfang von SMS-Nachrichten zu mieten.

Sie können diese Anfrage verwenden, wenn Sie Nachrichten von mehreren verschiedenen Diensten oder von einem, aber über einen längeren Zeitraum empfangen müssen.

Sicherheit

apikey

BearerAuth

OAuth2Berechtigungen: rent-scope

rent-scope: grants access to renting phone numbers from Onlinesim

Parameter

query5

Name	Typ	Beschreibung
`country`	`integer` ≥ 1	Internationaler Telefoncode des Landes (gemäß E.164-Standard, ohne "+"-Zeichen), siehe Liste der Länder Standard:`7`Beispiel:`46`
`days`*	`integer` ≥ 1	Anfangszeitraum der Miete (in Tagen), verfügbare Zeiträume sind in der Antwort tariffsRent angegeben Beispiel:`1`
`extension`	`boolean`	Auto-Verlängerung (wenn aktiviert, verlängert die Miete automatisch um 30 Tage nach Ablauf, wenn genügend Guthaben auf dem Konto vorhanden ist) Standard:`true`
`pagination`	`boolean`	Message-Paginierung
`lang`	`string`	Antwortsprache: `fr` - Französisch, `de` - Deutsch, `ru` - Russisch, `en` - Englisch, `zh` - Chinesisch. Beachten Sie, dass die Übersetzung nur für Zeichenfolgenwerte von Feldern durchgeführt wird, z. B. Namen von Diensten oder Ländern. Die Feldnamen selbst, Fehler bei der Ausführung von Anfragen und allgemein akzeptierte Werte (z. B. Werte von Feldern true/false für boolesche Parameter) bleiben auf Englisch. Enumeration:`frderuenzh`Standard:`ru`Beispiel:`en`

Antworten

200

Erfolgreiche Antwort auf die Anfrage getRentNum: Der Server gibt eine Nummer mit den angegebenen Parametern zur Miete aus oder wirft eine Ausnahme.

Content-Typeapplication/json

Schema

Responseobject

responseoneOf

1, wenn die Anfrage erfolgreich ausgeführt wurde, oder gibt eine Fehlermeldung aus

Beispiel:1

Eins von

[0]integer

[1]string

itemobject

statusinteger

Mietstatuscode, unmittelbar nach der Ausgabe immer 0:

0 - Warten auf Bestätigung des Vorgangs (SMS muss innerhalb von 20 Minuten nach der Bestellung empfangen werden, andernfalls wird der Vorgang storniert und die Mittel auf das Kontoguthaben zurückerstattet)

1 - Miete aktiv

2 - DEPRECATED Nummer deaktiviert

3 - DEPRECATED Mietfehler

4 - Nummer wurde eingefroren

Beispiel:0

messagesobject

current_pageinteger

Alle Nachrichten sind in umgekehrter chronologischer Reihenfolge sortiert und nach Seiten gruppiert, wobei jede Seite 10 Nachrichten enthält (die erste Seite enthält die letzten 10 Nachrichten)

≥ 1

Beispiel:1

dataobject[]

itemsobject

frominteger

Nummer der ersten Nachricht auf dieser Seite

≥ 1

Beispiel:1

last_pageinteger

Nummer der letzten Seite mit empfangenen SMS-Nachrichten

≥ 0

Beispiel:12

per_pageinteger

Anzahl der auf einer Seite angezeigten Nachrichten

Standard:20Beispiel:20

tointeger

Nummer der letzten Nachricht auf dieser Seite

≥ 0

Beispiel:2

totalinteger

Gesamtanzahl der von dieser Nummer empfangenen Nachrichten

≥ 0

Beispiel:4

countryinteger

Internationaler Telefoncode des Landes (gemäß E.164-Standard, ohne "+"-Zeichen), siehe Liste der Länder

≥ 1

Standard:7Beispiel:46

rentinteger

Statuscode der Miete, unmittelbar nach der Ausgabe immer 0:

0 - Warten auf Bestätigung (SMS muss innerhalb der ersten 20 Minuten nach der Bestellung empfangen werden, andernfalls wird für den Vorgang eine Rückerstattung durchgeführt)

1 - Miete ist aktiv

2 - DEPRECATED Nummer nicht verfügbar

3 - DEPRECATED Mietfehler

4 - Nummer wurde eingefroren

Enumeration:01234

extensioninteger

Verfügbarkeit der Verlängerung der Miete dieser Nummer:

0 - Verlängerung nicht verfügbar

1 - Verlängerung verfügbar

2 - Auto-Verlängerung (die Miete wird automatisch um 30 Tage verlängert, wenn die aktuelle Laufzeit abläuft, wenn genügend Guthaben vorhanden ist)

Enumeration:012Beispiel:1

checked_timestring

Datum und Uhrzeit, zu der die Nummer zur Miete ausgegeben wurde

Format:date-timeBeispiel:2022-07-17 11:55:13

sumnumber

Mietkosten

≥ 0

Beispiel:215.5

numberstring

Telefonnummer ohne Ländercode

Beispiel:9108501010

tzidinteger

Vorgangs-ID

≥ 1

Beispiel:10000

timeinteger

Verbleibende Mietzeit (in Minuten)

≥ 0

Beispiel:19

daysinteger

Verbleibende Mietzeit (in Tagen)

≥ 0

Beispiel:0

hoursinteger

Verbleibende Mietzeit (in Stunden)

≥ 0

Beispiel:14

extendobject

Verlängerungskosten

"extension_period_in days"integer

Kosten für die Verlängerung der Miete um X Tage

checkedboolean

Aktivierungsstatus der Nummer (zur Aktivierung muss die Nummer innerhalb von 20 Minuten nach Beginn des Vorgangs eine SMS empfangen, andernfalls wird automatisch eine Rückerstattung durchgeführt und der Vorgang geschlossen)

reloadinteger

Verfügbarkeit der Nummernneuladung:

0 - Neuladung nicht verfügbar

1 - Neuladung verfügbar

Beispiel:1

day_extendinteger

Kosten für die Verlängerung der Miete um 1 Tag

≥ 1

Beispiel:36

m_extboolean

Analoger Algorithmus für die Verlängerung

freezeboolean

Status der "Einfrierung" der Nummer: wenn true - Nummer ist eingefroren, und um die Miete fortzusetzen, muss sie aufgetaut werden

Beispiele

Successfully issued rental number37 Zeilen

{
  "response": 1,
  "item": {
    "status": 0,
    "messages": {
      "current_page": 1,
      "data": [],
      "from": 1,
      "last_page": 0,
      "per_page": 20,
      "to": 0,
      "total": 0
    },
    "country": 7,
    "rent": 3,
    "extension": 1,
    "checked_time": "2022-07-17 21:41:20",
    "sum": 215.5,
    "number": "9915584307",
    "tzid": 22867974,
    "time": 19,
    "days": 0,
    "hours": 0,
    "extend": {
      "1": 36,
      "3": 108,
      "7": 252,
      "15": 540,
      "30": 1080
    },
    "checked": false,
    "reload": 0,
    "day_extend": 36,
    "m_ext": false,
    "freeze": false
  }
}

Codebeispiele

Beispiele werden generiert...