POST /finishActivationRent
Mietvorgang einer virtuellen Nummer abschließen
Diese Anfrage wird vom Onlinesim-Server gesendet, um den aktuellen Mietvorgang 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:
- wenn die SMS vom bestellten Dienst erfolgreich empfangen wurde und der Kunde den Mietvorgang vorzeitig schließt;
- wenn die SMS vom bestellten Dienst nicht empfangen wurde und der Vorgang nach Ablauf des Schutzintervalls (20 Minuten ab Erstellung) geschlossen wird
TIP
Sie können denselben Endpunkt verwenden, der für das Schließen von SMS-Empfangsvorgängen verwendet wird (FINISH_ACTIVATION, v1), oder einen separaten Endpunkt ausschließlich für Mietvorgänge verwenden. Bei der ersten Option müssen Sie ihn jedoch so modifizieren, dass Ihr Server die Anfrage zum Schließen eines Mietvorgangs korrekt verarbeitet.
WARNING
Ihr Server muss innerhalb von 10 Sekunden nach Erhalt der Anfrage eine Antwort über die erfolgreiche Schließung des Mietvorgangs senden. Wenn nach Ablauf dieser Zeit keine Antwort erfolgt, wird die aktuelle Anfrage automatisch abgebrochen (eine neue Anfrage zum Schließen wird gesendet).
DANGER
Bitte schließen Sie Vorgänge auf Ihrer Seite nicht, bevor Sie von uns die Anfrage FINISH_ACTIVATION erhalten haben. Das selbstständige Schließen von Vorgängen kann zu einer Desynchronisation der Status und einer fehlerhaften Verarbeitung nachfolgender Anfragen führen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
Authorization* | string | Siehe Details hier Beispiel: Bearer apikey |
Anforderungs-Body
Anfragetext vom Onlinesim-Server
Content-Type:
application/jsonBodyobject
actionstringErforderlich
Name der Methode, in diesem Fall FINISH_ACTIVATION
Enumeration:
FINISH_ACTIVATIONStandard:
FINISH_ACTIVATIONBeispiel:
FINISH_ACTIVATIONactivationIdintegerErforderlich
ID des Vorgangs (wird von Ihrem Server zugewiesen)
≥ 1
Beispiel:
355statusintegerErforderlich
Statuscode des Vorgangs, enum:
1 - Die Nummer wurde nicht für den angegebenen Diensttyp bestellt (z. B. Sie versuchen, eine Nachricht für den Dienst “Empfang” zu senden, wenn die Nummer für “Miete” bestellt wurde)
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:
134Beispiel:
3keystringErforderlich
API-Schlüssel Ihres Onlinesim-Partnerprofils
servicestringErforderlich
Name des Dienstes. Für Miete immer rent
Enumeration:
rentBeispiel:
rentsumnumber
Gesamtkosten der Miete einschließlich aller Verlängerungsperioden in Rubel (dieser Betrag wird Ihrem Onlinesim-Partnerkonto bei erfolgreichem Abschluss des Mietvorgangs gutgeschrieben)
Beispiel:
870Antworten
200
“Die Antwort Ihres Servers auf die Anfrage FINISH_ACTIVATION
muss im folgenden Format sein:”
Codebeispiele
Keine Codebeispiele verfügbar