rent

Mietzeit einer virtuellen Nummer verlängern

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

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.

Nur eine bestätigte Miete (status 1 oder 4), die mit extension=1 gemietet wurde, kann verlängert werden. Der Preis des Zeitraums aus ihrem extend wird sofort abgebucht; days werden zu rent und stop_time addiert, der Preis zu sum. Nach jedem Aufruf (erfolgreich oder nicht) kann dieselbe tzid 10 Sekunden lang nicht verlängert werden. POST mit denselben Parametern funktioniert ebenfalls.

Sicherheit

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

Parameter

query5
NameTypBeschreibung
tzid*integer

ID des Mietvorgangs. Ohne sie lautet die Antwort TRY_AGAIN_LATER

daysinteger

Verlängerungszeitraum in Tagen, einer der Schlüssel von extend der Miete (siehe getRentState). Jeder andere Wert ergibt TRY_AGAIN_LATER

Standard:1
paginationboolean

true (Standard) — messages eines Mietvorgangs wird in Seiten aufgeteilt (siehe page und per_page); false — messages ist eine flache Liste von SMS, neueste zuerst

Standard:true
numberinteger

Beliebiger Wert: Die Antwort enthält zusätzlich time_seconds und guard_interval_remaining_seconds

langstring

Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): fr, de, ru, en oder zh. Jede Methode akzeptiert ihn; Methoden ohne solche Texte antworten in jeder Sprache gleich. Feldnamen, Fehlercodes und andere feste Werte bleiben auf Englisch. Ohne den Parameter: ru für getTariffs, getNumbersStats und getFreeList; sonst die Sprache des Profils bei Anfragen mit Schlüssel, Englisch bei Anfragen ohne. Ein nicht unterstützter Wert wird durch die Standardsprache ersetzt

Enumeration:frderuenzh

Antworten

200Die verlängerte Miete oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[0]object
[1]object
[2]object

Beispiele

Virtual number rental was successfully renewedZeilen: 51

Die Miete der Nummer wurde erfolgreich verlängert

{
  "response": 1,
  "item": {
    "status": 1,
    "messages": {
      "current_page": 1,
      "data": [
        [
          {
            "id": 1,
            "service": "Google",
            "text": "G-070051 is your Google verification code.",
            "code": "070051",
            "created_at": "2026-11-19 10:01:12"
          }
        ]
      ],
      "from": 1,
      "last_page": 1,
      "per_page": 20,
      "to": 1,
      "total": 1
    },
    "country": 7,
    "rent": 4,
    "days_autoextend": 3,
    "extension": 1,
    "checked_time": "2026-11-19 10:00:00",
    "sum": 2.4,
    "number": "9915584307",
    "start_time": "2026-11-19 10:00:00",
    "stop_time": "2026-11-23 10:00:00",
    "webhook_url": null,
    "tzid": 22867974,
    "time": 2880,
    "days": 2,
    "hours": 48,
    "extend": {
      "1": 0.9,
      "3": 1.5,
      "7": 3,
      "15": 5.5,
      "30": 9
    },
    "checked": true,
    "reload": 0,
    "day_extend": 0.3,
    "m_ext": false,
    "freeze": false
  }
}
Invalid values were passed in the parameters or the operation is already closed

Die Miete kann nicht verlängert werden: falsche tzid oder days, der Vorgang ist geschlossen, oder ein wiederholter Aufruf innerhalb von 10 Sekunden

{
  "response": "TRY_AGAIN_LATER"
}
Low balance

Das Guthaben ist niedriger als der Preis der Verlängerung

{
  "response": "WARNING_LOW_BALANCE"
}
429HTTP 429: mehr als 400 Anfragen pro Minute von einem Profil (von einer IP bei Anfragen ohne Schlüssel) oder mehr als 200 Anfragen pro Minute von einem Profil an getNum, getPrice, getState und setOperationOk zusammen
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.

Beispiele

Rate limit

Anfragelimit überschritten

{
  "response": "TRY_AGAIN_LATER"
}
456HTTP 456: Der API-Schlüssel ist ungültig oder das OAuth-Token ist abgelaufen. Öffentliche Methoden antworten genauso, wenn ein ungültiger Schlüssel übergeben wird
Content-Typeapplication/json
Schema
schemaobject
responsestringErforderlich
Fehlercode. Die Codes, die jede Methode liefern kann, stehen in der Einleitung; jede Methode führt ihre eigenen auf. Die Liste ist nicht geschlossen: behandeln Sie einen unbekannten Code als allgemeinen Fehler und protokollieren Sie ihn.

Beispiele

Invalid key

Ungültiger API-Schlüssel oder abgelaufenes Token

{
  "response": "ERROR_WRONG_KEY"
}

Codebeispiele

Beispiele werden generiert...