Informationen über Nummern mit aktiven Vorgängen erhalten
GEThttps://onlinesim.io/api/getState.php
Liefert die Vorgänge Ihres Kontos mit Status und empfangenen SMS — der Bereich „Meine Nummern“ im persönlichen
Konto. tzid beschränkt die Antwort auf einen Vorgang. POST mit denselben Parametern funktioniert ebenfalls.
msgenthält die aktuelle SMS: standardmäßig den Code, mitmessage_to_code=0den vollständigen Text, mitmsg_list=1alle SMS. setOperationRevise schaltet die aktuelle SMS auf die nächste weiter.- Antworten werden 5 Sekunden lang zwischengespeichert: Dieselbe Anfrage erhält früher dieselbe Antwort. Ohne
tzidwird ein setOperationRevise-Aufruf daher erst nach dieser Zeit sichtbar.


Sicherheit
Parameter
query10
| Name | Typ | Beschreibung |
|---|---|---|
tzid | integer | Vorgangs-ID: nur diesen Vorgang zurückgeben |
message_to_code | integer |
Enumeration: 012Standard:1 |
orderby | string | Reihenfolge der Vorgänge in der Liste nach Vorgangs-ID: Enumeration: ascdescStandard:desc |
msg_list | integer |
Enumeration: 01Standard:0 |
clean | integer | Nur mit |
last | integer | Nur mit Enumeration: 01Standard:0 |
number | boolean | Mit diesem Parameter (beliebiger Wert, auch |
with_response | integer |
Enumeration: 01Standard:0 |
text | integer | Nur mit Enumeration: 01Standard:0 |
lang | string | Sprache der Texte in der Antwort (Länder- und Dienstnamen, Statustexte): Enumeration: frderuenzh |
Antworten
200Vorgänge oder ein Fehler
application/jsonschemaoneOf
[0]object[]Vorgänge des Kontos (nie leer: ohne Vorgänge lautet die Antwort ERROR_NO_OPERATIONS)
[1]objectMit with_response
tzid und text: nur msg dieses Vorgangs[3]object
[4]object
Beispiele
Ein Vorgang mit einer SMS
[
{
"country": 373,
"sum": 0.36,
"service": "telegram",
"number": "+37360000000",
"webhook_url": null,
"subscription_package_id": null,
"response": "TZ_NUM_ANSWER",
"tzid": 10000,
"time": 596,
"msg": "123456",
"form": "index"
}
]Keine Vorgänge
{
"response": "ERROR_NO_OPERATIONS"
}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"
}