single-service activations

Virtuelle Nummer für den ausgewählten Dienst kaufen

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

Kauft eine Nummer des gewählten Landes für den SMS-Empfang vom Dienst — wie die Schaltfläche „Nummer kaufen“ im persönlichen Konto. POST mit denselben Parametern funktioniert ebenfalls.

  • Der Preis des Dienstes wird bei der Ausgabe der Nummer auf dem Guthaben reserviert.
  • tzid aus der Antwort ist die Vorgangs-ID für getState und setOperationOk.
  • Mit number enthält die Antwort auch die Telefonnummer und die Vorgangsdetails.
  • Mit dev_id werden 5 % des Preises dem Entwickler gutgeschrieben.

Sicherheit

Parameter

query6
NameTypBeschreibung
service*string

Dienst-Slug aus der Dienste-Liste. Der Wert wird in Kleinbuchstaben umgewandelt und . durch _ ersetzt; einige alte Namen werden auf die aktuellen abgebildet (z. B. blizzard → battle_net)

countryinteger

Ländercode. Standard: das in den Profileinstellungen gespeicherte Land

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

numberboolean

Mit diesem Parameter (beliebiger Wert, auch 0) enthält die Antwort auch die Telefonnummer und die Vorgangsdetails

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

200Vorgangs-ID oder ein Fehler
Content-Typeapplication/json
Schema
schemaoneOf
Eins von
[0]objectDie Felder nach tzid sind nur vorhanden, wenn die Anfrage number enthält
[1]object
[2]object

Beispiele

success

Nummer ausgegeben

{
  "response": 1,
  "tzid": 10000
}
NO_NUMBER

Keine Nummern verfügbar

{
  "response": "NO_NUMBER"
}
WARNING_LOW_BALANCE

Nicht genug Guthaben

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