Skip to content

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/json
Bodyobject
smsIdintegerErforderlich

ID des Vorgangs (wird von Ihrem Server zugewiesen)

≥ 1
Beispiel:355
phoneFromstringErforderlich

Name oder Nummer des Absenders

Beispiel:Instagram
phonestringErforderlich

Telefonnummer mit aktivem Vorgang, die SMS empfangen hat

Beispiel:79088081050
textstringErforderlich

Text der Nachricht

Beispiel:Your verification code is 800142
actionstringErforderlich

Name der Methode, in diesem Fall PUSH_SMS

Enumeration:PUSH_SMS
Standard:PUSH_SMS
Beispiel:PUSH_SMS
keystringErforderlich

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