Wie man eine SMS in F# empfängt

Der einfachste Weg, SMS von F# aus zu senden, ist die Verwendung der integrierten HTTP/Rest-SMS-API von Ozeki SMS Gateway. Wenn Sie diese API verwenden, senden Sie SMS-Nachrichten, indem Sie eine HTTP-Post-Anfrage an das SMS-Gateway stellen. Die HTTP-Post-Anfrage enthält eine Nachricht im JSON-Format. Das SMS-Gateway sendet diese SMS an die Empfängertelefonnummer und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

wie man SMS-Nachrichten mit F# empfängt
Abbildung 1 - Empfangen von SMS-Nachrichten mit F#

F#-Code zum Empfangen von SMS

Das folgende F#-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der F#-Bibliothek Ozeki.Libs.Rest empfangen können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt, und Sie können sie in Ihren Projekten verwenden und modifizieren.

Program.fs
open Ozeki.Libs.Rest

[<EntryPoint>]
let main argv =
    let configuration = new Configuration (
        Username = "http_user",
        Password = "qwe123",
        ApiUrl = "http://127.0.0.1:9509/api")

    let api = new MessageApi(configuration)

    let result = api.DownloadIncoming();

    printfn $"Es gibt {result.Length} Nachrichten im Posteingang:"
    for message in result do
        printfn $"Von: {message.FromAddress} - Text: {message.Text}"
    0

Wie man das F#-SMS-Beispiel verwendet:

Dieses F#-SMS-Beispiel kann in jeder .NET- oder .NET-Core-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Ozeki.Libs.Rest-DLL als Referenz zu Ihrem Projekt hinzufügen. Nachdem die Projektreferenz hinzugefügt wurde, müssen Sie die Direktive "open Ozeki.Libs.Rest;" in den Header-Bereich Ihres F#-Quellcodes einfügen. Dies ermöglicht Ihnen die Verwendung der Klassen, die von der Ozeki.Libs.Rest-Bibliothek bereitgestellt werden. Sie können die MessageApi-Klasse verwenden, um die SMS vom SMS-Gateway zu empfangen.

ReceiveSms.fs herunterladen

Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: ReceiveSms.fs.zip (51,2Kb)

Was ist in der ReceiveSms.fs-Datei enthalten?

Die ReceiveSms.fs-Datei enthält die Ozeki.Libs.Rest-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Sie finden dort auch das ReceiveSms-Projekt in der ZIP-Datei, das den Beispielcode enthält, der Ihnen zeigt, wie Sie SMS empfangen können. Dieser Beispielcode ist unten aufgeführt.

was ist in der ozeki receive sms zip
Abbildung 2 - Was ist in ReceiveSms.fs.zip enthalten

Wie man SMS von F# aus empfängt (Schnellschritte)

So empfangen Sie SMS von F# aus:

  1. Installieren Sie Ozeki SMS Gateway
  2. Verbinden Sie Ozeki SMS Gateway mit dem Mobilfunknetz
  3. Senden Sie eine Test-SMS über die Ozeki-GUI
  4. Erstellen Sie einen HTTP-SMS-API-Benutzer
  5. Starten Sie Visual Studio
  6. Erstellen Sie eine Lösung namens ReceiveSms.sln
  7. Fügen Sie ein F#-Konsolenprojekt hinzu: ReceiveSms.fsproj
  8. Fügen Sie den Code in Program.fs oder ReceiveSms.fs ein
  9. Erstellen Sie eine HTTP-Anfrage zum Empfangen der SMS
  10. Lesen Sie die HTTP-Antwort
  11. Schreiben Sie die Antwort auf die Konsole
  12. Überprüfen Sie die Protokolle im SMS-Gateway

Installieren Sie Ozeki SMS Gateway und erstellen Sie einen HTTP-API-Benutzer

Um SMS von F# aus senden 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 F#-Code in Visual Studio 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-Benutzer 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 F#-Code ausführen.

HTTP-API-URL zum Empfangen von SMS von F# aus

Um SMS von F# aus zu senden, muss Ihre F#-Anwendung eine HTTP-Anfrage an das SMS-Gateway stellen. 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 F#-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 F# aus

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

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

Wenn Sie beispielsweise den Benutzernamen 'http_user' und das Passwort 'qwe123' kodieren, erhalten Sie den folgenden base64-kodierten String: aHR0cF91c2VyOnF3ZTEyMw==. Um

HTTP-Anfrageheader zum Empfangen von SMS von F# aus

Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage einfügen. 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 mit F#

Um die SMS zu übermitteln, sendet Ihre F#-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. Sie enthält die Nummer des Empfängers und den Text der Nachricht.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Connection: Keep-Alive
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
	

HTTP-Antwort, die vom F#-SMS-Beispiel empfangen wurde

Sobald das SMS-Gateway diese Anfrage erhält, wird es eine HTTP-Antwort generieren. 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.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 10 Jun 2021 11:02:26 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "94219121-e5b5-4845-9721-074f5307c9a4",
	      "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-06-10 11:46:16",
	      "valid_until": "2021-06-17 11:46:16",
	      "time_to_send": "2021-06-10 11:46:16",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "d6f832b2-dbc8-4b1b-8b47-44b3bb6658bf",
	      "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-06-10 11:46:16",
	      "valid_until": "2021-06-17 11:46:16",
	      "time_to_send": "2021-06-10 11:46:16",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "0bf86b3a-e4a9-4d8e-970c-ed486b02db7a",
	      "from_connection": "http_user@localhost",
	      "from_address": "+362011111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-06-10 11:46:16",
	      "valid_until": "2021-06-17 11:46:16",
	      "time_to_send": "2021-06-10 11:46:16",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}
	

F#-SMS-Beispiel: ReceiveSms.sln

Wie man das ReceiveSms.sln-Projekt herunterlädt (Video-Tutorial)

In diesem Video lernen Sie, wie Sie das Beispiel-F#-Projekt herunterladen können. Das Video beginnt mit der Download-Seite und endet mit dem geöffneten Projekt. Sie lernen, wie Sie das Projekt herunterladen und was Sie damit tun müssen, um SMS-Nachrichten zu empfangen. Das Video ist nur 58 Sekunden lang, aber sehr hilfreich. Dank der detaillierten Darstellung werden Sie keine Probleme haben, den Schritten zu folgen.

Video 1 - Wie man das oben gezeigte Beispielprojekt herunterlädt und ausführt (Video-Tutorial)

Der Beispielcode unten ist Teil der ReceiveSms.sln Visual Studio Solution. Eine Visual Studio Solution kann mehrere Projekte und mehrere Dateien enthalten. In dieser Solution gibt es nur zwei Projekte: ReceiveSms.fsproj, Ozeki.Libs.Rest.csproj, und eine Datei: Program.fs.

Abbildung 3 - ReceiveSms.sln

Wie man das ReceiveSms.sln-Projekt verwendet (Video-Tutorial)

In diesem Video lernen Sie, wie Sie das Projekt verwenden können, um SMS-Nachrichten mit Hilfe von F# zu empfangen. Das Video beginnt mit dem Öffnen des Ozeki SMS Gateways und führt Sie bis zur Überprüfung der Eingabeaufforderung mit den empfangenen Nachrichten. Das Video ist nur 54 Sekunden lang und sehr detailliert. Dadurch werden Sie keine Probleme haben, dem Tutorial zu folgen.

Video 2 - Wie man die ReceiveSms.fs-Solution verwendet (Video Tutorial)

Ausführen des F#-SMS-Beispiels unter Windows

Wenn Sie Windows verwenden, um dieses in F# geschriebene SMS-Beispiel auszuführen, werden Sie feststellen, dass Sie eine leicht bessere Leistung erhalten, als wenn Sie es unter Linux ausführen. Um zu verstehen, warum dies geschieht, müssen Sie bedenken, dass F# das .NET-Framework für die Code-Ausführung verwendet. Dies liegt daran, dass die .NET-Implementierung unter Windows für Leistung optimiert ist, während mono, die .NET-Implementierung unter Linux, in diesem Bereich noch etwas aufholen muss.

Fazit

Der obige Artikel erklärte die Schritte zum Empfangen von SMS in F# mit dem Ozeki SMS Gateway. Mit dieser Lösung können Sie Textnachrichten von Ihren Kunden in Ihrem F#-Programm empfangen, unterstützt durch den Ozeki SMS Gateway. Wichtig zu erwähnen ist, dass der Ozeki SMS Gateway in jedem Land funktioniert und SMS über verschiedene Mobilfunkverbindungen senden und empfangen kann, sodass Sie sich keine Sorgen machen müssen, falls der Informationsaustausch international wird.

Um Ihre Lernreise fortzusetzen, besuchen Sie die Tutorial-Seite von Ozeki, wo Sie weitere Informationen zu Themen wie Terminplanung in F# finden.

Jetzt müssen Sie nur noch den Ozeki SMS Gateway herunterladen und die Arbeit kann beginnen!

More information