Mietvorgang für virtuelle Nummer abschließen
GEThttps://onlinesim.io/api/rent/closeRentNum.php
Diese Anfrage schließt den angegebenen Mietvorgang (mit Ausnahme der Miete von US-Nummern – diese kann ausschließlich bei Ablauf der Vorgangsfrist geschlossen werden).
Eine Miete, die auf die erste SMS wartet (status 0), kann 120 Sekunden nach dem Start oder sofort nach einer beliebigen SMS geschlossen werden; ihre Reservierung wird aufgehoben. Ein Hinweis auf einen verbotenen Absender (service notify) bestätigt die Miete nicht, daher wird auch eine solche Miete mit aufgehobener Reservierung geschlossen. Eine bestätigte Miete wird ohne Rückerstattung geschlossen. Ist eine echte SMS eingegangen, hat die Miete aber noch status 0, wird die Miete bestätigt (der Preis wird abgebucht, ohne Rückerstattung) und geschlossen; die Antwort ist "1". POST mit denselben Parametern funktioniert ebenfalls.
Sicherheit
Parameter
query2
| Name | Typ | Beschreibung |
|---|---|---|
tzid* | integer | ID des Mietvorgangs. Ohne sie lautet die Antwort |
lang | string | Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): Enumeration: frderuenzh |
Antworten
200"1" oder ein Fehler
application/jsonschemaoneOf
[0]object
[1]object
[2]object
Beispiele
Erfolgreiches Schließen des Mietvorgangs
{
"response": "1"
}Keine aktiven Mietvorgänge
{
"response": "ERROR_NO_OPERATIONS"
}Die Miete wartet auf die erste SMS und seit dem Start sind keine 120 Sekunden vergangen
{
"response": "NO_COMPLETE_TZID"
}Eine US-Nummer kann nicht vorzeitig geschlossen werden
{
"response": "NO_CLOSE_RENT_US"
}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"
}