Wie man eine SMS in F# plant

Der einfachste Weg, SMS von F# aus zu versenden, 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 in der Zukunft mit F# sendet
Abbildung 1 - F# plant SMS für zukünftige Zustellung

F#-Code zum Senden einer geplanten SMS an ein Mobiltelefon

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 senden können. Diese Bibliothek wird Ihnen kostenlos zur Verfügung gestellt und kann in Ihren Projekten verwendet und modifiziert werden.

Program.fs 
open System
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 msg = new Message(
        ToAddress = "+36201111111", 
        Text = "Hallo, Welt!",
        TimeToSend = DateTime.Parse("2021-06-07 11:44:00"))

    let api = new MessageApi(configuration)

    let result = api.Send(msg)

    printfn $"{result.ToString()}"
    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 Kopfbereich Ihres F#-Quellcodes einfügen. Dies ermöglicht Ihnen die Verwendung der Klassen der Ozeki.Libs.Rest-Bibliothek. 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 senden. Das SMS-Gateway leitet Ihre Nachricht entweder über eine drahtlose Verbindung oder über das Internet an das Mobilfunknetz weiter.

SendScheduledSms.fs herunterladen

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

Was befindet sich in der SendScheduledSms.fs-Datei?

Die SendScheduledSms.fs-Datei enthält die Ozeki.Libs.Rest-Bibliothek, die Ihnen alle notwendigen Werkzeuge zum Senden und Empfangen von SMS-Nachrichten bietet. Sie finden auch das SendScheduledSms-Projekt in der ZIP-Datei, das 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 SendScheduledSms.fs.zip

Wie man SMS von F# aus sendet (Schnelle Schritte)

Um SMS von F# aus zu senden:

  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 SendScheduledSms.sln
  7. Fügen Sie ein F#-Konsolenprojekt hinzu: SendScheduledSms.fsproj
  8. Fügen Sie den Code in Program.fs oder SendScheduledSms.fs ein
  9. Lesen Sie die HTTP-Antwort
  10. Ü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 ist der nächste Schritt, 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 ist die Erstellung eines HTTP-SMS-API-Benutzerkontos. 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 Senden 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 Senden 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==. Zum Senden

HTTP-Anfrageheader zum Senden 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- und einen Authorization-Header einfügen. 

Content-Type: application/json
Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
HTTP-Anfrage zum Senden geplanter SMS aus 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. 

POST /api?action=sendmsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 336
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509

{
  "messages": [
    {
      "message_id": "d51ca3ba-4159-4dee-8541-106f8df76f91",
      "to_address": "+36201111111",
      "text": "Hallo, Welt!",
      "create_date": "2021-06-11 14:09:22",
      "valid_until": "2021-06-18 14:09:22",
      "time_to_send": "2021-06-11 14:44:00",
      "submit_report_requested": true,
      "delivery_report_requested": true,
      "view_report_requested": true,
      "tags": []
    }
  ]
}

HTTP-Antwort, die vom F#-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 anzeigt, ob die SMS-Übermittlungsanfrage erfolgreich war oder nicht. Es wird auch eine JSON-kodierte Struktur zurückgegeben, die Ihnen nützliche Details über die Übermittlung der Nachricht liefert. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.118 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 11 Jun 2021 08:44:45 GMT
Server: 10/10.3.118
Transfer-Encoding: chunked

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "Nachrichten wurden zur Zustellung in die Warteschlange gestellt.",
  "data": {
    "total_count": 1,
    "success_count": 1,
    "failed_count": 0,
    "messages": [
      {
        "message_id": "04682902-5360-4189-8082-ab455433d141",
        "from_station": "%",
        "to_address": "+36201111111",
        "to_station": "%",
        "text": "Hallo, Welt!",
        "create_date": "2021-06-11 14:09:22",
        "valid_until": "2021-06-18 14:09:22",
        "time_to_send": "2021-06-11 14:44:00",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": false,
        "tags": [
          {
            "name": "Typ",
            "value": "SMS:TEXT"
          }
        ],
        "status": "SUCCESS"
      }
    ]
  }
}

F#-SMS-Beispiel: SendScheduledSms.sln



Wie Sie die Projektdatei von der Downloadseite herunterladen (Video-Tutorial)

In diesem Video lernen Sie, wie Sie das F#-Beispielprojekt herunterladen. Das Video beginnt mit der Downloadseite und endet mit dem geöffneten Projekt. Sie lernen, wie Sie das Projekt herunterladen und was danach zu tun ist. Das Video ist nur 1 Minute lang, aber sehr hilfreich. Dank der detaillierten Darstellung werden Sie keine Probleme haben, den Schritten zu folgen.

Video 1 - Wie Sie das oben gezeigte Beispielprojekt herunterladen und ausführen (Video-Tutorial)

Der untenstehende Beispielcode ist Teil der SendScheduledSms.sln Visual Studio Solution. Eine Visual Studio Solution kann mehrere Projekte und mehrere Dateien enthalten. In dieser Solution gibt es nur ein Projekt: SendScheduledSms.fsproj, und eine Datei: Program.fs.

Abbildung 3 - SendScheduledSms.sln

Wie Sie das geplante SMS-Projekt verwenden (Video-Tutorial)

In diesem Video lernen Sie, wie Sie das Projekt verwenden, um geplante SMS-Nachrichten zu senden. Das Video beginnt mit dem Öffnen des Ozeki SMS Gateways und führt Sie bis zur Überprüfung des mit Nachrichten gefüllten "postponed"-Ordners. Das Video ist nur 1:26 Minuten lang und sehr detailliert. Dadurch werden Sie keine Probleme haben, dem Tutorial zu folgen.

Video 2 - Wie Sie die Send-scheduled-SMS.fs-Solution verwenden (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 unter Linux. Um zu verstehen, warum dies geschieht, müssen Sie bedenken, dass F# das .NET-Framework für die Codeausfü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 aufzuholen hat.

Fazit

Der Artikel erklärte die Schritte der SMS-Planung in F# mit Hilfe des Ozeki SMS Gateways. Die SMS-Planung ist ein sehr nützliches Werkzeug, wenn Sie sicherstellen möchten, dass Ihre Nachrichten die Stoßzeiten der Empfänger vermeiden, damit die Nachrichten nicht ignoriert oder vergessen werden. Das Ozeki SMS Gateway ermöglicht die Protokollierung von SMS-Nachrichten in einer Datenbank und bietet verschiedene Berichtsfunktionen, um Informationen über die SMS-Verbindung bereitzustellen.

Beenden Sie Ihre Studien hier nicht, besuchen Sie die Tutorial-Seite von Ozeki, wo Sie mehr über Themen wie Löschen in F# lesen können.

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

More information