post{yourserver}/finishActivation

POST /finishActivation

Aktuellen Vorgang abschließen

Diese Anfrage wird vom Onlinesim-Server gesendet, um den aktuellen Vorgang mit einem bestimmten Status zu schließen (der von den Ergebnissen des Vorgangs abhängt).

Standardmäßig wird diese Anfrage nach Ablauf der Vorgangszeit gesendet. Die Anfrage kann auch vorzeitig in einem von zwei Fällen gesendet werden:

  1. wenn die SMS vom bestellten Dienst erfolgreich empfangen wurde und der Kunde den Vorgang selbst schließt;
  2. wenn die SMS vom bestellten Dienst nicht empfangen wurde und der Kunde den Vorgang abbricht.

Der Empfang einer Anfrage mit dem Status 1 ist ein Signal dafür, dass die Nummer aus irgendeinem Grund keine SMS vom bestellten Dienst empfangen konnte. Im Wesentlichen ist es ein Signal dafür, dass es besser ist, diese Nummer für den angegebenen Dienst nicht auszugeben, da ohne zusätzliche Überprüfungen der nächste Vorgang mit hoher Wahrscheinlichkeit fehlschlagen wird. Sie können diesen Status als Indikator verwenden, um problematische Paare "Nummer + Dienst" zu überprüfen und sie in Zukunft von der Ausgabe auszuschließen. Wenn Sie diesen Status nicht verwenden möchten, können Sie ihn ignorieren und weiterhin Nummern für diesen Dienst ausgeben.

Parameter

header1
NameTypBeschreibung
Authorization*string

Siehe Details hier

Anforderungs-Body

Anfragetext vom Onlinesim-Server

Content-Typeapplication/json
Schema
Bodyobject
actionstringErforderlich

Name der Methode, in diesem Fall FINISH_ACTIVATION

Enumeration:FINISH_ACTIVATIONStandard:FINISH_ACTIVATION
activationIdintegerErforderlich

Vorgangs-ID (wird von Ihrem Server zugewiesen)

≥ 1
sumnumber

Betrag, der dem Guthaben des Partners für die erbrachte Dienstleistung gutgeschrieben wurde (in Rubel)

statusintegerErforderlich

Statuscode des Vorgangs, enum:

1 - Die Nummer konnte innerhalb von drei (oder mehr) Vorgängen keine SMS vom angeforderten Dienst empfangen. Überprüfen Sie, ob es Probleme mit dieser Nummer und dem Dienst gibt. Es kann sinnvoll sein, sie in Zukunft von der Ausgabe auszuschließen

3 - Vorgang erfolgreich abgeschlossen

4 - Vorgang wurde abgebrochen, Nachricht wurde nicht empfangen

5 - Für den Vorgang wurde eine Rückerstattung durchgeführt, bei Fehlern und Problemen mit der Nachricht.

Enumeration:1345
keystringErforderlich

API-Schlüssel Ihres Onlinesim-Partnerprofils

Beispiele

Example payload of Onlinesim server FINISH_ACTIVATION request
{
  "action": "FINISH_ACTIVATION",
  "activationId": 75489,
  "status": 3,
  "key": "apikey"
}

Antworten

200

Erfolgreiche Antwort Ihres Servers auf die Anfrage FINISH_ACTIVATION muss im folgenden Format sein:

Content-Typeapplication/json
Schema
Responseobject
statusstring

Status der Anfrageausführung (SUCCESS oder ERROR)

Enumeration:SUCCESSERROR

Beispiele

Successful response example from your server
{
  "status": "SUCCESS"
}

Codebeispiele

Beispiele werden generiert...