Virtuelle Telefonnummer für die Miete kaufen
GEThttps://onlinesim.io/api/rent/getRentNum.php
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.
Der Preis ist der days-Preis des Landes in tariffsRent.
Er wird auf dem Guthaben reserviert, aber nicht abgebucht: Die Miete beginnt mit status 0 und wartet auf die
erste SMS. Die erste SMS bestätigt die Miete (status 1): Der Preis wird abgebucht, und die Miete dauert ab dem
Start days Tage. SMS der Miete werden auch an den Webhook des Profils gesendet. POST mit denselben Parametern funktioniert ebenfalls.
Sicherheit
Parameter
query8
| Name | Typ | Beschreibung |
|---|---|---|
country | integer | Ländercode. Standard: das Standardland aus den Profileinstellungen. Ein unbekannter Code ergibt |
days | integer | Mietdauer in Tagen, einer der Schlüssel von Standard: 1 |
extension | boolean |
Standard: true |
reject | string | Nummernpräfixe (mit Ländervorwahl), die nicht vergeben werden dürfen: eine kommagetrennte Liste, ein JSON-Array oder |
dev_id | integer | Onlinesim-Profil-ID des Entwicklers der Software, die die Anfrage sendet. Wenn der Vorgang bezahlt ist, werden 5 % seiner Kosten den Partnereinnahmen dieses Profils gutgeschrieben |
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 gemietete Nummer oder ein Fehler
application/jsonschemaoneOf
[0]object
[1]object
[2]object
Beispiele
Virtual number successfully rentedZeilen: 41
Gibt Informationen über den Mietvorgang zurück
{
"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,
"days_autoextend": 3,
"extension": 1,
"checked_time": "2026-11-19 10:00:00",
"sum": 1.5,
"number": "9915584307",
"start_time": "2026-11-19 10:00:00",
"stop_time": "2026-11-19 10:20:00",
"webhook_url": null,
"tzid": 22867974,
"time": 19,
"days": 0,
"hours": 0,
"extend": {
"1": 0.9,
"3": 1.5,
"7": 3,
"15": 5.5,
"30": 9
},
"checked": false,
"reload": 0,
"day_extend": 0.3,
"m_ext": false,
"freeze": false
}
}Derzeit keine freie Nummer dieses Landes
{
"response": "NO_NUMBER"
}Das Guthaben ist niedriger als der Preis
{
"response": "WARNING_LOW_BALANCE"
}Das Land hat keine Miete für diese Anzahl von Tagen
{
"response": "UNDEFINED_DAYS"
}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"
}