single-service activations

Länder mit Diensten, Preisen und Bestand

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

Ein Land mit seinen Diensten, Preisen (USD) und der Anzahl verfügbarer Nummern; country=all liefert alle Länder als Map: Ländercode → Land. Eine erfolgreiche Antwort hat kein Feld response. 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.

Antworten werden 60 Sekunden lang zwischengespeichert.

Parameter

query3
NameTypBeschreibung
countrystring

Ländercode oder all (auch 0 oder ein leerer Wert) für alle Länder

Standard:44
servicestring

Behält nur die Dienste, deren Schlüssel service_<Slug> diesen Wert enthält (ohne Beachtung der Groß-/Kleinschreibung). Funktioniert nur für ein Land, bei country=all ignoriert

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

200Ein Land, alle Länder oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[0]object
[1]objectMit country=all oder country=0: Ländercode → Land
[2]object
[3]object

Beispiele

countryZeilen: 20

Ein Land

{
  "name": "united_kingdom",
  "position": 2,
  "code": 44,
  "other": false,
  "new": false,
  "enabled": true,
  "services": {
    "service_vkcom": {
      "count": 363,
      "popular": false,
      "code": 44,
      "price": 0.36,
      "id": 1,
      "service": "VK",
      "slug": "vkcom"
    }
  },
  "locale_name": "United Kingdom"
}
NO_COUNTRY

Unbekanntes Land

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