rent

Nummer mieten

GEThttps://onlinesim.io/stubs/handler_api.php?action=getRentNumber

Mietet eine Nummer des Landes für den Empfang von SMS beliebiger Absender. Der Mietpreis für den Zeitraum wird auf dem Guthaben reserviert und mit der ersten SMS abgebucht. Die Miete wird ohne Verlängerungsoption bestellt.

Fehler als JSON ({"status":"error","message":…}):

  • NO_NUMBERS — derzeit keine freie Nummer, oder das Land hat keine Miete für diesen Zeitraum
  • NO_BALANCE — nicht genug Geld auf dem Guthaben

Fehler als Text: BAD_COUNTRY (unbekanntes oder nicht numerisches country) und die allgemeinen Fehler.

Sicherheit

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

Parameter

query3
NameTypBeschreibung
action*string

Name der Methode: getRentNumber

Enumeration:getRentNumber
countryinteger
≥ 0

Länder-ID aus getCountries (id). Ohne Angabe: Russland

Standard:0Beispiel:16
rent_timeinteger
≥ 0

Mietdauer in Stunden, aufgerundet auf ganze Tage (2 → 1 Tag, 25 → 2 Tage); 0 bedeutet 24. Die Anzahl der Tage muss ein Mietzeitraum des Landes sein

Standard:4Beispiel:24

Antworten

200Die gemietete Nummer oder ein Fehler
text/plain
Schema
schemaoneOf
Eins von
[0]string
Enumeration:BAD_COUNTRY
[1]string
Fehler, den jede Methode (auch die JSON-Methoden) als Text liefert:
  • BAD_KEY — der API-Schlüssel ist falsch oder fehlt
  • BANNED — das Konto ist gesperrt
  • BAD_ACTION — unbekannte Methode oder ein Fehler ohne eigenen Code (zum Beispiel ein vorübergehender Fehler oder zu viele gleichzeitige Anfragen); prüfen Sie die Anfrage und wiederholen Sie sie später
  • Too many requests. Please wait a moment before trying again. — das Limit des Konverters für getNumber, getRentNumber, setStatus und setRentStatus (3 Anfragen pro Sekunde, 150 in 30 Sekunden)
Enumeration:BAD_KEYBANNEDBAD_ACTIONToo many requests. Please wait a moment before trying again.
application/json
Schema
schemaoneOf
Eins von
[0]object
[1]objectFehler einer JSON-Methode. Die Codes sind bei jeder Methode aufgeführt

Beispiele

rented

Nummer gemietet

{
  "status": "success",
  "phone": {
    "id": 22867858,
    "endDate": "2026-11-20T10:00:00+03:00",
    "number": "7400123456"
  }
}
noNumbers

Keine freie Nummer

{
  "status": "error",
  "message": "NO_NUMBERS"
}

Codebeispiele

Beispiele werden generiert...