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
Parameter
query5
| Name | Typ | Beschreibung |
|---|---|---|
tzid* | integer | ID des Mietvorgangs. Ohne sie lautet die Antwort |
days | integer | Verlängerungszeitraum in Tagen, einer der Schlüssel von Standard: 1 |
pagination | boolean |
Standard: true |
number | integer | Beliebiger Wert: Die Antwort enthält zusätzlich |
lang | string | Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): Enumeration: frderuenzh |
Antworten
200Die verlängerte Miete oder ein Fehler
application/jsonschemaoneOf
[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
}
}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"
}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
application/jsonschemaobject
Beispiele
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
application/jsonschemaobject
Beispiele
Ungültiger API-Schlüssel oder abgelaufenes Token
{
"response": "ERROR_WRONG_KEY"
}