rent

Informationen zu Tarifen für die Miete von Nummern erhalten

GEThttps://onlinesim.io/api/rent/tariffsRent.php

Gibt die Miettarife eines Landes zurück (oder aller Länder, wenn country nicht angegeben ist): Mietzeiträume, Preise in USD und freie Nummern.

Im Gegensatz zum normalen SMS-Empfang bedeutet die Miete einer Nummer eine längere Nutzungsdauer. Im Gegensatz zum normalen Empfang können Sie während der gesamten Mietdauer eine beliebige Anzahl von SMS-Nachrichten von verschiedenen Absendern erhalten: von Websites und Apps bis hin zu SMS von normalen Mobilnummern.

Wenn Sie eine Nummer mit Verlängerungsmöglichkeit mieten (extension=1 in getRentNum), können Sie die Miete vor ihrem Ende verlängern, sobald die erste SMS eingegangen ist.

Ein Schlüssel ist nicht nötig. Ein mit der Anfrage gesendeter Schlüssel wird trotzdem geprüft: Ein ungültiger ergibt HTTP 456, und ein OAuth-Token muss rent-scope enthalten. POST mit denselben Parametern funktioniert ebenfalls.

Parameter

query2
NameTypBeschreibung
countryinteger

Ländercode. Der Wert muss genau einem Code entsprechen (07 passt zu nichts). Ein unbekannter Code oder ein Land ohne Miete ergibt []; ohne den Parameter (oder mit 0) werden alle Länder zurückgegeben

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

200Tarife aller Länder, eines Landes, [] oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[0]objectLänderkarte. Schlüssel sind Ländercodes als Zeichenketten (z. B. "7", "46", "373"), Werte sind rentCountryTariff-Objekte
[1]object
[2]object[]Leeres Array: Das Land ist unbekannt oder hat keine Miete, oder die Tarife sind noch nicht geladenmaxItems: 0Beispiel:[]
[3]object

Beispiele

List of number rental tariffs for all countriesZeilen: 48

Liste der Miet- und Verlängerungsfristen und -tarife für alle Länder

{
  "7": {
    "code": 7,
    "enabled": true,
    "name": "russia",
    "new": false,
    "position": 7,
    "count": {
      "1": 120,
      "3": 120,
      "7": 120,
      "15": 120,
      "30": 120
    },
    "days": {
      "1": 0.9,
      "3": 1.5,
      "7": 3,
      "15": 5.5,
      "30": 9
    },
    "extend": 120,
    "confirm": false,
    "ext_counts": {
      "1": 120,
      "3": 120,
      "7": 120,
      "15": 120,
      "30": 120
    }
  },
  "46": {
    "code": 46,
    "enabled": false,
    "name": "sweden",
    "new": false,
    "position": 46,
    "count": {
      "7": 0,
      "30": 0
    },
    "days": {
      "7": 4.5,
      "30": 9.5
    },
    "extend": 0
  }
}
List of number rental tariffs for one countryZeilen: 30

Liste der Miet- und Verlängerungsfristen und -tarife für das angegebene Land

{
  "code": 7,
  "enabled": true,
  "name": "russia",
  "new": false,
  "position": 7,
  "count": {
    "1": 120,
    "3": 120,
    "7": 120,
    "15": 120,
    "30": 120
  },
  "days": {
    "1": 0.9,
    "3": 1.5,
    "7": 3,
    "15": 5.5,
    "30": 9
  },
  "extend": 120,
  "confirm": false,
  "ext_counts": {
    "1": 120,
    "3": 120,
    "7": 120,
    "15": 120,
    "30": 120
  }
}
Unknown country

Unbekanntes Land oder Land ohne Miete

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