POST /v1/PUSH_SMS
SMS an Onlinesim senden
WARNING
Die URL des Onlinesim-Servers wird von den Mitarbeitern des Partner-Supports bereitgestellt. Bitte beachten Sie, dass die URL des Onlinesim-Servers im Beispiel durch einen Platzhalter ersetzt wurde.
Dies ist ein Webhook zum Senden einer Nachricht an den Onlinesim-Server. Diese Anfrage sollte nur dann ausgeführt werden, wenn Ihre Nummer eine Nachricht auf die bestellte Nummer erhalten hat, um sie (die Nachricht) anschließend an den Onlinesim-Server zu übermitteln.
Wenn Sie eine Antwort mit dem Status 200(OK) erhalten haben, kann die SMS in Ihrer Datenbank als erfolgreich zugestellt markiert werden (es ist nicht erforderlich, die Anfrage erneut zu senden).
Wenn der Statuscode von 200(OK) abweicht, muss die Anfrage mit demselben Inhalt nach 10 Sekunden erneut gesendet werden (außer bei Erhalt der Fehler NO_OPERATION oder BAD_SERVICE).
WARNING
Der Anfrageheader 'Content-Type' muss die UTF-8-Kodierung als Wert enthalten ('Content-Type': 'application/json; charset=utf-8').
Unten sind Antworten mit möglichen Fehlern beschrieben:
NO_OPERATION/NO_OP- dieser Fehler tritt auf, wenn Sie versuchen, eine SMS an eine Nummer zu senden, die keine aktive Operation hat;BAD_SERVICE- dieser Fehler tritt auf, wenn Sie versuchen, eine SMS von einem Dienst zu senden, der von unserem Server blockiert wurde (Bank, Zahlungssystem, Mikrofinanzinstitut usw.);IGNORED- dieser Fehler tritt auf, wenn Sie versuchen, eine SMS von einem Dienst zu senden, der sich von dem unterscheidet, den der Kunde bestellt hat (erscheint nur, wenn die Nachrichtenfilterung auf unserer Seite durchgeführt wird);SERVICE_BAN- dieser Fehler tritt auf, wenn Sie versuchen, eine SMS von einem Dienst zu senden, den Sie auf die schwarze Liste gesetzt haben (Sie können Dienste zur schwarzen Liste hinzufügen, was es Kunden nicht ermöglicht, Ihre Nummern für den Empfang von Nachrichten von diesen Diensten zu bestellen)
Parameter
Keine Parameter
Anforderungs-Body
PUSH_SMS Webhook: Ihr Server sollte diese Anfrage senden, wenn das Ereignis eintritt (wenn die bestellte Nummer eine Nachricht erhalten hat).
Content-Type:
application/jsonBodyobject
smsIdintegerErforderlich
ID des Vorgangs (wird von Ihrem Server zugewiesen)
≥ 1
Beispiel:
355phoneFromstringErforderlich
Name oder Nummer des Absenders
Beispiel:
InstagramphonestringErforderlich
Telefonnummer mit aktivem Vorgang, die SMS empfangen hat
Beispiel:
79088081050textstringErforderlich
Text der Nachricht
Beispiel:
Your verification code is 800142actionstringErforderlich
Name der Methode, in diesem Fall PUSH_SMS
Enumeration:
PUSH_SMSStandard:
PUSH_SMSBeispiel:
PUSH_SMSkeystringErforderlich
API-Schlüssel Ihres Onlinesim-Partnerprofils
Antworten
200
Antwort des Onlinesim-Servers
404
NO_OPERATION / NO_OP
Dieser Fehler tritt auf, wenn Sie versuchen, eine SMS an eine Nummer zu senden, die keine aktive Operation hat
429
TOO_MANY_ATTEMPTS
Dieser Fehler tritt bei einer großen Anzahl von Anfragen in kurzer Zeit auf
Codebeispiele
Keine Codebeispiele verfügbar