rent

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

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

Parameter

query8
NameTypBeschreibung
countryinteger

Ländercode. Standard: das Standardland aus den Profileinstellungen. Ein unbekannter Code ergibt UNDEFINED_COUNTRY

daysinteger

Mietdauer in Tagen, einer der Schlüssel von days des Landes in tariffsRent. Jeder andere Wert ergibt UNDEFINED_DAYS

Standard:1
extensionboolean

true/1 (Standard) — die Miete kann später mit extendRentState verlängert werden; false/0 — sie kann nie verlängert werden (extend ist []). Andere Werte als true, 1, on, yes gelten als false. Die automatische Verlängerung ist ein separater Modus, der hier nicht aktiviert werden kann

Standard:true
rejectstring

Nummernpräfixe (mit Ländervorwahl), die nicht vergeben werden dürfen: eine kommagetrennte Liste, ein JSON-Array oder reject[]=…. Zum Beispiel schließt 911,912123 indische Nummern aus, die mit +911 und +912123 beginnen. Ohne den Parameter werden die in den Profileinstellungen gespeicherten Präfixe verwendet

dev_idinteger

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

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 gemietete Nummer oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[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
  }
}
No free number

Derzeit keine freie Nummer dieses Landes

{
  "response": "NO_NUMBER"
}
Low balance

Das Guthaben ist niedriger als der Preis

{
  "response": "WARNING_LOW_BALANCE"
}
Undefined days

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
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...