posthttps://{ourserver.com}/v1/PUSH_SMS

Webhook POST /v1/PUSH_SMS

SMS an Onlinesim senden

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).

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

header2
NameTypBeschreibung
Authorization*string

Siehe Details hier

Content-Type*string

Header Content-Type und Kodierung

Enumeration:application/json; charset=utf-8

Anforderungs-Body

PUSH_SMS Webhook: Ihr Server sollte diese Anfrage senden, wenn das Ereignis eintritt (wenn die bestellte Nummer eine Nachricht erhalten hat).

Content-Typeapplication/json
Schema
Bodyobject
smsIdintegerErforderlich

ID des Vorgangs (wird von Ihrem Server zugewiesen)

≥ 1
phoneFromstringErforderlich

Name oder Nummer des Absenders

phonestringErforderlich

Telefonnummer mit aktivem Vorgang, die SMS empfangen hat

textstringErforderlich

Text der Nachricht

actionstringErforderlich

Name der Methode, in diesem Fall PUSH_SMS

Enumeration:PUSH_SMSStandard:PUSH_SMS
keystringErforderlich

API-Schlüssel Ihres Onlinesim-Partnerprofils

Beispiele

Example payload of your server PUSH_SMS request
{
  "smsId": 124971,
  "phoneFrom": "vk",
  "phone": "79104041216",
  "text": "Your OTP 46875",
  "action": "PUSH_SMS",
  "key": "apikey"
}

Antworten

200

Antwort des Onlinesim-Servers

Content-Typeapplication/json
Schema
Responseobject
statusstring

Status der Antwort des Onlinesim-Servers

Enumeration:SUCCESSERROR

Beispiele

Onlinesim server response example for successfuly received SMS
{
  "status": "SUCCESS"
}
When pushing SMS to a number that has no active operation
NO_OP
When pushing SMS from a service that is banned by our server (banks, payment systems, etc.)
BAD_SERVICE
When pushing SMS from a service that is differs from the one the client has ordered (only appears when filtration is done on our side)
IGNORED
When pushing SMS from a service you've added to the blacklist
SERVICE_BAN
When rate limit for PUSH_SMS_RENT requests is exceeded
TOO_MANY_ATTEMPTS
404

NO_OPERATION / NO_OP

Dieser Fehler tritt auf, wenn Sie versuchen, eine SMS an eine Nummer zu senden, die keine aktive Operation hat

Codebeispiele

Beispiele werden generiert...