single-service activations

Tarife für Einzelaktivierungen

GEThttps://onlinesim.io/api/getTariffs.php

Länder und für das gewählte Land die Dienste mit Preis und Anzahl verfügbarer Nummern — die Dienstliste des Bereichs „Nummer kaufen“ im persönlichen Konto. POST mit denselben Parametern funktioniert ebenfalls.

Öffentliche Methode: Es wird kein Schlüssel benötigt. Ein gesendeter Schlüssel wird trotzdem geprüft (ein ungültiger ergibt HTTP 456); ein OAuth-Token muss, falls gesendet, sms-scope enthalten.

  • Die Dienste sind in Seiten aufgeteilt: count pro Seite, page ab 1.
  • Preise in USD. Mit locale_price werden sie in die Währung der Sprache lang umgerechnet (ru — RUB, zh — CNY, fr und de — EUR, en — USD), nicht in die Währung Ihres Guthabens.
  • Mit Schlüssel kommen die favorisierten Länder und Dienste des Profils in favorite_countries und favorite_services und werden aus countries und services entfernt.
  • Die Listen werden 60 Sekunden lang zwischengespeichert.

Dienstliste

Parameter

query8
NameTypBeschreibung
countryinteger

Land, dessen Dienste aufgelistet werden. Ein unbekannter Code ergibt ein leeres services

Standard:1
countinteger
≥ 1

Dienste pro Seite. Werte unter 1 werden zu 1

Standard:30
pageinteger
≥ 1

Seite der Dienstliste, ab 1. Werte unter 1 werden zu 1

Standard:1
filter_countrystring

Behält nur die Länder, deren Name oder Code mit diesem Wert beginnt. Der Wert wird in Kleinbuchstaben umgewandelt und ein führendes + entfernt, daher passt er in der Praxis auf original oder code. Das gewählte country bleibt immer erhalten; mit filter_service bleiben auch Länder mit einem passenden Dienst

filter_servicestring

Behält nur die Dienste, deren Slug oder Name diesen Wert enthält (ohne Beachtung der Groß-/Kleinschreibung). Filtert auch die favorisierten Dienste und lässt in countries nur Länder mit einem solchen Dienst (plus das gewählte country)

filterstring

Standardwert für filter_country und filter_service; wird in filter zurückgegeben

locale_priceinteger

1 — Preise in der Währung der Sprache lang statt in USD. Wird als Boolean gelesen: 1, true, on, yes schalten es ein; 0, false, off, no, ein leerer oder jeder andere Wert lassen es aus

Enumeration:01Standard:0
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 oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[0]object
[1]object
[2]object

Beispiele

successZeilen: 34

Tarife für Russland, ohne Schlüssel

favorite_countries und favorite_services sind hier {} und im Beispiel weggelassen

{
  "response": "1",
  "countries": {
    "_7": {
      "name": "Russia",
      "original": "russia",
      "code": 7,
      "pos": 0,
      "other": false,
      "new": false,
      "enable": true
    }
  },
  "services": {
    "_vkcom": {
      "id": 1,
      "count": 3721,
      "price": "0.55",
      "service": "VKontakte",
      "slug": "vkcom"
    },
    "_telegram": {
      "id": 2,
      "count": "?",
      "price": "1.20",
      "service": "Telegram",
      "slug": "telegram"
    }
  },
  "page": 1,
  "country": 7,
  "filter": "",
  "end": false
}
INTERVAL_CONCURRENT_REQUESTS_ERROR

Zu viele Anfragen

{
  "response": "INTERVAL_CONCURRENT_REQUESTS_ERROR"
}
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...