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.
tzidaus der Antwort ist die Vorgangs-ID für getState und setOperationOk.- Mit
numberenthält die Antwort auch die Telefonnummer und die Vorgangsdetails. - Mit
dev_idwerden 5 % des Preises dem Entwickler gutgeschrieben.
Sicherheit
Parameter
query6
| Name | Typ | Beschreibung |
|---|---|---|
service* | string | Dienst-Slug aus der Dienste-Liste. Der Wert wird in Kleinbuchstaben umgewandelt und |
country | integer | Ländercode. Standard: das in den Profileinstellungen gespeicherte Land |
reject | string | Nummernpräfixe (mit Ländervorwahl), die nicht vergeben werden dürfen: eine kommagetrennte Liste, ein JSON-Array oder |
dev_id | integer | 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 |
number | boolean | Mit diesem Parameter (beliebiger Wert, auch |
lang | string | Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): Enumeration: frderuenzh |
Antworten
200Vorgangs-ID oder ein Fehler
application/jsonschemaoneOf
[0]objectDie Felder nach tzid sind nur vorhanden, wenn die Anfrage number enthält
[1]object
[2]object
Beispiele
Nummer ausgegeben
{
"response": 1,
"tzid": 10000
}Keine Nummern verfügbar
{
"response": "NO_NUMBER"
}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
application/jsonschemaobject
Beispiele
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
application/jsonschemaobject
Beispiele
Ungültiger API-Schlüssel oder abgelaufenes Token
{
"response": "ERROR_WRONG_KEY"
}