gethttps://onlinesim.io/api/getState.php

GET /api/getState.php

Informationen über Nummern mit aktiven Vorgängen erhalten

Gibt detaillierte Informationen über alle aktiven Nummern des Profils zurück (oder nur über die angegebene Nummer).

Ermöglicht es, den Status der Vorgänge Ihres Kontos zu überprüfen und die auf Ihre bestellten Nummern empfangenen SMS-Nachrichten zu lesen.

Sie können diese Anfrage verwenden, um eine Liste aller Nachrichten von aktiven Nummern für deren anschließende Verarbeitung zu erhalten.

Ist faktisch eine Repräsentation des Blocks aktiver Vorgänge ("Meine Nummern") des persönlichen Kontos.

Aktive Vorgänge

Sicherheit

apikey

BearerAuth

OAuth2Berechtigungen: sms-scope

sms-scope: grants access to manage numbers for the SMS receiving service from Onlinesim

Parameter

query6

Name	Typ	Beschreibung
`tzid`	`integer` ≥ 1	Vorgangs-ID Beispiel:`10000`
`message_to_code`	`integer`	SMS-Anzeigemodus: `0` - die gesamte SMS anzeigen, `1` - nur den Code aus der SMS anzeigen Enumeration:`01`Beispiel:`1`
`orderby`	`string`	Sortierreihenfolge: `asc` - aufsteigend sortieren; `desc` - absteigend sortieren Enumeration:`ascdesc`Standard:`asc`Beispiel:`asc`
`msg_list`	`integer` ≥ 0, ≤ 1	Anzeigemodus der Nachrichtenliste: `0` - nur die aktive Nachricht, `1` - als Liste Enumeration:`01`Beispiel:`1`
`clean`	`integer` ≥ 0, ≤ 1	Nachrichtenanzeigemodus (nur für msg_list = 0): `0` - zuvor angezeigte Nachrichten anzeigen, `1` - zuvor angezeigte Nachrichten nicht anzeigen Enumeration:`01`Beispiel:`1`
`lang`	`string`	Antwortsprache: `fr` - Französisch, `de` - Deutsch, `ru` - Russisch, `en` - Englisch, `zh` - Chinesisch. Beachten Sie, dass die Übersetzung nur für Zeichenfolgenwerte von Feldern durchgeführt wird, z. B. Namen von Diensten oder Ländern. Die Feldnamen selbst, Fehler bei der Ausführung von Anfragen und allgemein akzeptierte Werte (z. B. Werte von Feldern true/false für boolesche Parameter) bleiben auf Englisch. Enumeration:`frderuenzh`Standard:`ru`Beispiel:`en`

Antworten

200

Erfolgreiche Antwort auf die Anfrage getState: Der Server gibt aktuelle Informationen über die aktiven Nummern Ihres Kontos zurück oder wirft eine Ausnahme.

Content-Typeapplication/json

Schema

Responseobject[]

Array aktiver Nummern (laufender Vorgänge) für Ihr Konto

itemsobject

Informationen zum Vorgang

countryinteger

Internationaler Telefoncode des Landes (gemäß E.164-Standard, ohne "+"-Zeichen)

≥ 1

Standard:7Beispiel:46

suminteger

Kosten des Dienstes in Rubel

≥ 0

Beispiel:14

servicestring

Name des Dienstes mit denselben Werten wie in der Anfrage getNum

Beispiel:Facebook

numberstring

Telefonnummer im internationalen Format

Beispiel:+46050101010

responsestring

Aktueller Status des Vorgangs (enum):

TZ_INPOOL - Vorgang wartet auf Ausgabe der Nummer

TZ_NUM_WAIT - Warten auf SMS-Empfang

TZ_NUM_ANSWER - SMS wurde empfangen

TZ_OVER_EMPTY - SMS wurde nicht innerhalb der zugewiesenen Zeit empfangen

TZ_OVER_OK - Vorgang wurde erfolgreich abgeschlossen

ERROR_NO_TZID - tzid (Vorgangs-ID) nicht angegeben

ERROR_NO_OPERATIONS - keine aktiven Vorgänge auf Ihrem Konto

Enumeration:TZ_INPOOLTZ_NUM_WAITTZ_NUM_ANSWERTZ_OVER_OKERROR_NO_TZIDERROR_NO_OPERATIONSBeispiel:TZ_NUM_ANSWER

tzidinteger

Vorgangs-ID

≥ 1

Beispiel:10000

timeinteger

Verbleibende Zeit des Vorgangs in Sekunden

≥ 0

Beispiel:281

formstring

Art des Empfangs (Online-Empfang - index)

Beispiel:index

Beispiele

Successful getState response example

[
  {
    "country": 7,
    "sum": 14,
    "service": "Facebook",
    "number": "+46050101010",
    "response": "TZ_INPOOL",
    "tzid": 10000,
    "time": 281,
    "form": "index"
  }
]

Codebeispiele

Beispiele werden generiert...