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

GET /api/rent/extendRentState.php

Mietzeit einer virtuellen Nummer verlängern

Verlängert die Miete für den angegebenen Zeitraum (in Tagen).

Diese Anfrage ist erforderlich, wenn die Mietdauer der Nummer bald abläuft, Sie aber planen, sie weiter zu nutzen.

Sicherheit

apikey

BearerAuth

OAuth2Berechtigungen: rent-scope

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

Parameter

query3

Name	Typ	Beschreibung
`tzid`*	`integer` ≥ 1	Vorgangs-ID Beispiel:`10000`
`days`*	`integer` ≥ 0	Verlängerungszeitraum der Miete (in Tagen). Kann nur Werte annehmen, die im Abschnitt `extend` der Antwort getRentState angegeben sind Beispiel:`15`
`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 extendRentState: Verlängert die Miete der Nummer mit den angegebenen Parametern 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

Liste der aktiven Mietnummern Ihres Profils

statusinteger

Beispiel:1

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

messagesobject

current_pageinteger

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

Beispiel:1

dataoneOf[]

itemsoneOf

Eins von

[0]object

[1]object[]

frominteger

Nummer der ersten Nachricht auf dieser Seite

≥ 1

Beispiel:1

last_pageinteger

Nummer der letzten Seite mit empfangenen SMS-Nachrichten

≥ 1

Beispiel:12

per_pageinteger

Anzahl der auf einer Seite angezeigten Nachrichten (standardmäßig 20)

Standard:20Beispiel:20

tointeger

Nummer der letzten Nachricht auf der aktuellen Seite

≥ 1

Beispiel:12

totalinteger

Gesamtanzahl der von dieser Nummer empfangenen Nachrichten

≥ 1

Beispiel:234

sumnumber

Gesamtkosten der Miete (Anfangsperiode + Verlängerungsperioden)

≥ 1

Beispiel:251.5

countryinteger

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

Beispiel:46

checked_timestring

Datum und Uhrzeit, zu der diese Nummer vom Kunden gemietet wurde

Beispiel:2022-07-17 21:41:20

numberstring

Ausgegebene virtuelle Nummer (ohne Ländercode)

Beispiel:9915584307

rentinteger

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

Enumeration:01234Beispiel:4

tzidinteger

Vorgangs-ID

≥ 1

Beispiel:10000

timeinteger

Verbleibende Mietzeit (in Minuten)

≥ 1

Beispiel:5750

daysinteger

Verbleibende Mietzeit (in Tagen)

≥ 0

Beispiel:3

hoursinteger

Verbleibende Mietzeit (in Stunden)

≥ 1

Beispiel:95

extendobject

Verlängerungskosten

#period_in_days#integer

Kosten für die Verlängerung der Miete für den angegebenen Zeitraum

≥ 1

Beispiel:36

checkedboolean

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

reloadinteger

Verfügbarkeit des Neustarts der Nummer:

0 - Neustart nicht verfügbar

1 - Neustart 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

Successful rental extention response47 Zeilen

{
  "response": 1,
  "item": {
    "status": 1,
    "extension": 1,
    "messages": {
      "current_page": 1,
      "data": [
        [
          {
            "id": 1,
            "service": "Google",
            "text": "G-249833 – Ваш проверочный код.",
            "code": "249833",
            "created_at": "2022-07-17 21:46:58"
          }
        ]
      ],
      "from": 1,
      "last_page": 1,
      "per_page": 20,
      "to": 1,
      "total": 1
    },
    "sum": 251.5,
    "country": 7,
    "checked_time": "2022-07-17 21:41:20",
    "number": "9915584307",
    "rent": 4,
    "tzid": 22867974,
    "time": 5750,
    "days": 3,
    "hours": 95,
    "extend": {
      "1": 36,
      "3": 108,
      "7": 252,
      "15": 540,
      "30": 1080
    },
    "checked": true,
    "reload": 0,
    "day_extend": 36,
    "m_ext": false,
    "freeze": false
  }
}

Codebeispiele

Beispiele werden generiert...