Wie man SMS von Scala empfängt

Der einfachste Weg, SMS von Scala zu empfangen, ist die Verwendung der integrierten HTTP/Rest-SMS-API der Ozeki SMS Gateway. Wenn Sie diese API verwenden, erhalten Sie SMS-Nachrichten, indem Sie eine HTTP-Get-Anfrage an das SMS-Gateway senden. Die HTTP-Get-Anfrage enthält einen Ordnernamen, von dem Sie Nachrichten empfangen möchten. Das SMS-Gateway sendet alle Nachrichten aus diesem Ordner an Ihre Scala-Clientanwendung und gibt eine HTTP 200 OK-Antwort auf Ihre Anfrage zurück.

wie man SMS von Scala empfängt
Abbildung 1 - Wie man SMS von Scala empfängt

Scala-Code zum Empfangen von SMS-Nachrichten auf dem Handy

Das folgende Scala-SMS-Codebeispiel zeigt, wie Sie eine geplante SMS mit der HTTP-Rest-SMS-API der Ozeki SMS Gateway unter Verwendung der Scala Ozeki.Libs.Rest-Bibliothek senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt, und Sie können sie in Ihren Projekten verwenden und ändern.

ReceiveSms.scala
import Ozeki.Libs.Rest.{ Configuration, MessageApi }


object main  {
  def main(args: Array[String]): Unit = {
      
    val configuration = Configuration(
      Username = "http_user",
      Password = "qwe123",
      ApiUrl = "http://127.0.0.1:9509/api"
    )

    val api : MessageApi = MessageApi(configuration)

    val result = api.DownloadIncoming()

    println(result)

    for (message <- result.Messages) {
      println(message)
    }
  }
}
	

Code 1 - ReceiveSms.scala

So verwenden Sie das Scala-SMS-Beispiel:

Dieses Scala-SMS-Beispiel kann in jeder Scala-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-Bibliothek herunterladen. Nachdem die Bibliothek heruntergeladen wurde, müssen Sie einen Verweis darauf in Ihrem Scala-Quellcode hinzufügen. Dies ermöglicht Ihnen die Verwendung der Klassen, die von der Ozeki.Libs.Rest-Bibliothek bereitgestellt werden. Sie können die Message-Klasse verwenden, um die SMS zu erstellen. Sie können die MessageApi-Klasse verwenden, um die SMS an das SMS-Gateway zu empfangen. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.

ReceiveSms.scala herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und geändert werden.
Download: ReceiveSms.scala.zip (90,6Kb)

Was befindet sich in der Datei ReceiveSms.scala.zip?

In der Datei ReceiveSms.scala.zip finden Sie die Datei ReceiveSms.scala, die den Beispielcode enthält, der Ihnen zeigt, wie Sie eine SMS senden können. Dieser Beispielcode ist unten aufgeführt.

Abbildung 2 - Was befindet sich in ReceiveSms.scala.zip

Wie man SMS von Scala empfängt (Einfache Anleitung)

So empfangen Sie SMS von Scala:

  1. Installieren Sie einen HTTP-API-Benutzer
  2. Aktivieren Sie "Log communication events" auf der Registerkarte "Advanced"
  3. Richten Sie Visual Studio ein
  4. Laden Sie die Datei ReceiveSms.scala.zip herunter und entpacken Sie sie
  5. Öffnen Sie das ReceiveSms.scala-Projekt mit der IntelliJ IDE
  6. Starten Sie die Ozeki SMS Gateway App
  7. Führen Sie den Scala-Code ReceiveSms.scala aus, indem Sie ihn in der IntelliJ IDE ausführen
  8. Überprüfen Sie die Protokolle, um zu sehen, ob die SMS gesendet wurde

Ozeki SMS Gateway installieren und einen HTTP-API-Benutzer erstellen

Um SMS von Scala empfangen zu können, müssen Sie zunächst Ozeki SMS Gateway installieren. Das SMS-Gateway kann auf demselben Computer installiert werden, auf dem Sie Ihren Scala-Code in einem beliebigen Texteditor wie Windows Notepad entwickeln. Nach der Installation besteht der nächste Schritt darin, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können eine Test-SMS über die Ozeki-GUI senden, um zu überprüfen, ob Ihre Mobilfunknetzverbindung funktioniert. Der letzte Schritt zur Vorbereitung Ihrer Umgebung besteht darin, einen HTTP-SMS-API-Benutzeraccount zu erstellen. Erstellen Sie einen Benutzer mit dem Benutzernamen "http_user" und dem Passwort "qwe123", damit das Beispiel ohne Änderungen funktioniert.

Nachdem die Umgebung eingerichtet ist, können Sie Ihren Scala-Code ausführen.

HTTP-API-URL zum Empfangen von SMS von Scala

Um SMS von Scala zu senden, muss Ihre Scala eine HTTP-Anfrage an das SMS-Gateway senden. Die API-URL wird unten angezeigt. Beachten Sie, dass die IP-Adresse (127.0.0.1) durch die IP-Adresse Ihres SMS-Gateways ersetzt werden sollte. Wenn Ozeki SMS Gateway auf demselben Computer installiert ist, auf dem die R-SMS-Anwendung läuft, kann dies 127.0.0.1 sein. Wenn es auf einem anderen Computer installiert ist, sollte es die IP-Adresse dieses Computers sein.

http://127.0.0.1:9509/api?action=rest
	

HTTP-Authentifizierung zum Empfangen von SMS von Scala

Um den Scala-SMS-Client zu authentifizieren, müssen Sie den Benutzernamen und das Passwort in einer base64-kodierten Zeichenkette in einer HTTP-Anfrage an den Server senden. Das verwendete Format lautet: base64(Benutzername+":"+Passwort). In Scala können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:

val usernamePassword = "%s:%s".format(Username, Password).getBytes()
val usernamePasswordEncoded = Base64.getEncoder.encodeToString(usernamePassword)
"Basic %s".format(usernamePasswordEncoded)
	

Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie die folgende base64-kodierte Zeichenkette: aHR0cF91c2VyOnF3ZTEyMw==. Zum Senden

HTTP-Anfrageheader zum Empfangen von SMS von Scala

Um die SMS-Nachrichten zu empfangen, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage aufnehmen. Beachten Sie, dass wir einen Content-Type-Header und einen Authorization-Header einfügen.

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
	

HTTP-Anfrage zum Empfangen von SMS aus Scala

Um die SMS zu übermitteln, sendet Ihre Scala-Anwendung eine HTTP-Anfrage ähnlich der unten gezeigten. Beachten Sie, dass diese Anfrage einen HTTP-Header-Teil und einen HTTP-Body-Teil enthält. Der HTTP-Body ist eine JSON-kodierte Datenzeichenfolge. Er enthält die Empfängernummern und die Texte der Nachrichten, die wir gesendet haben.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
HTTP2-Settings: AAEAAEAAAAIAAAABAAMAAABkAAQBAAAAAAUAAEAA
Connection: Upgrade, HTTP2-Settings
Upgrade: h2c
Content-Length: 0
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Java-http-client/16.0.1
	

HTTP-Antwort, die vom Scala-SMS-Beispiel empfangen wurde

Sobald das SMS-Gateway diese Anfrage erhält, generiert es eine HTTP-Antwort. Die HTTP-Antwort enthält einen Statuscode, der angibt, ob die SMS-Übermittlungsanfrage erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 15 Jul 2021 11:23:02 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "bf1960cf-1474-40ac-85aa-5487a6edeb7f",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36202222222",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-07-13 11:51:57",
	      "valid_until": "2021-07-20 11:51:57",
	      "time_to_send": "2021-07-13 11:51:57",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "df87cdf8-6e8b-4c99-a648-d2f24231bf04",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36201111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-07-13 11:51:57",
	      "valid_until": "2021-07-20 11:51:57",
	      "time_to_send": "2021-07-13 11:51:57",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "7308e035-f92d-4515-9d21-9bb80ef26e74",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36203333333",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-07-13 11:51:57",
	      "valid_until": "2021-07-20 11:51:57",
	      "time_to_send": "2021-07-13 11:51:57",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}
	

Wie man SMS aus Scala mit der Scala-SMS-API empfängt (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie die Datei ReceiveSms.scala.zip von dieser Seite herunterladen. Wenn Sie das Video ansehen, werden Sie feststellen, dass die Inhalte der ReceiveSms.scala.zip auf den Windows-Desktop platziert werden. Sie werden auch sehen, dass wir die Eingabeaufforderung verwenden, um die SMS zu senden.

Scala-SMS-Beispiel: ReceiveSms.scala

Der Beispielcode unten ist Teil der ReceiveSms.scala.

Beispielcode zum Empfangen von SMS mit Scala
Abbildung 3 - ReceiveSms.scala-Datei

Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde

Nachdem die SMS übermittelt wurde, ist es eine gute Idee, Ihr SMS-Gateway zu überprüfen, um zu sehen, was es empfangen hat. Sie können das Protokoll überprüfen, indem Sie die Details des HTTP-Benutzers in der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen.

Video 2 - Wie man überprüft, ob die SMS vom HTTP-Benutzer akzeptiert wurde (Video-Tutorial)

Zusammenfassung

Diese Anleitung zeigte die grundlegenden Schritte zum Empfangen von SMS in Scala mit Hilfe des Ozeki SMS Gateways. Wenn jeder Schritt sorgfältig befolgt wurde, sollte das Weiterleiten der eingehenden Nachrichten an ein Scala-Programm sehr einfach sein. Mit dieser Lösung können Sie sicherstellen, dass diese Nachrichten an einem Ort gesammelt werden, an dem sie sein sollten. Wichtig zu beachten ist, dass das Ozeki SMS Gateway in einer Umgebung läuft, die Sie kontrollieren, sodass Ihre Kontaktliste und Daten in sicheren Händen sind.

Lesen Sie weiter auf der Tutorial-Seite von Ozeki, wo Sie mehr Informationen zu Themen wie SMS-Planung in Scala finden.

Das Einzige, was jetzt noch zu tun ist, ist das Ozeki SMS Gateway herunterzuladen und loszulegen!

More information