Wie man SMS von Tcl/Tk empfängt

Der einfachste Weg, SMS von Tcl/Tk zu empfangen, 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-Get-Anfrage an das SMS-Gateway stellen. Die HTTP-Get-Anfrage enthält den Namen des Ordners, aus dem wir die SMS empfangen möchten. Das SMS-Gateway sendet die Nachrichten an den Tcl/Tk-API-Client und gibt eine HTTP-200-OK-Antwort auf Ihre Anfrage zurück.

Tcl/Tk-Code zum Senden von SMS an Mobiltelefone

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

source Ozeki.Libs.Rest.tcl


set configuration [ Configuration new ]
$configuration setUsername "http_user" 
$configuration setPassword "qwe123"
$configuration setApiUrl "http://127.0.0.1:9509/api"

set api [ MessageApi new $configuration ]

set result [ $api downloadIncoming ]

puts [ $result toString ]

for { set i 0 } { $i < [ llength [ $result getMessages ] ] } { incr i } {
    puts [ [ lindex [ $result getMessages ] $i ] toString ]
}
	

Wie man das Tcl/Tk-SMS-Beispiel verwendet:

Dieses Tcl/Tk-SMS-Beispiel kann in jeder Tcl/Tk-Anwendung verwendet werden. Um es zu verwenden, müssen Sie die Datei Ozeki.Libs.Rest.tcl zu Ihrem Projekt hinzufügen. Nachdem die Datei hinzugefügt wurde, müssen Sie die Anweisung "source Ozeki.Libs.Rest.tcl" in den Header-Bereich Ihres Tcl/Tk-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.

ReceiveSms.tcl herunterladen

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

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

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

Wie man SMS von Tcl/Tk sendet (Einfache Anleitung)

Um SMS von Tcl/Tk zu senden:

1. Installieren Sie einen HTTP-API-Benutzer
2. Aktivieren Sie "Log communication events" auf der Registerkarte "Advanced"
3. Laden Sie die Tcllib-Bibliothek herunter und installieren Sie sie
4. Laden Sie die Datei ReceiveSms.tcl.zip herunter und entpacken Sie sie
5. Öffnen Sie die Datei ReceiveSms.tcl in einem Texteditor
6. Starten Sie die Ozeki SMS Gateway App
7. Führen Sie den Tcl/Tk-Code ReceiveSms.tcl im Terminal aus
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 Tcl/Tk 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 Tcl/Tk-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 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 Tcl/Tk-Code ausführen.

HTTP-API-URL zum Senden von SMS von Tcl/Tk

Um SMS von Tcl/Tk zu senden, muss Ihre Tcl/Tk-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 Tcl/Tk-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 Tcl/Tk

Um den Tcl/Tk-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 Tcl/Tk können Sie den folgenden Code verwenden, um diese Kodierung durchzuführen:

set usernamePassword "$username:$password"
set usernamePasswordEncoded [ binary encode base64 $usernamePassword ]
return "Basic $usernamePasswordEncoded"
	

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

HTTP-Anfrageheader zum Senden von SMS von Tcl/Tk

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==
	

Um die SMS zu übermitteln, sendet Ihre Tcl/Tk-Anwendung eine HTTP-Anfrage ähnlich der untenstehenden. Beachten Sie, dass diese Anfrage einen HTTP-Header enthält, der den Namen des Ordners, aus dem wir Nachrichten empfangen möchten, sowie den base64-kodierten Benutzernamen und das Passwort enthält.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Host: 127.0.0.1:9509
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 10.0) http/2.9.0 Tcl/8.6.9
Connection: close
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Accept: */*
Accept-Encoding: gzip,deflate,compress
    

HTTP-Antwort, die vom Tcl/Tk-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
Transfer-Encoding: chunked
Content-Type: application/json; charset=utf8
Last-Modified: Wed, 04 Aug 2021 08:44:43 GMT
Server: 10/10.3.124 Microsoft-HTTPAPI/2.0
User-Agent: OZEKI 10.3.124 (www.myozeki.com)
Access-Control-Allow-Origin: *
Date: Wed, 04 Aug 2021 10:11:34 GMT
Connection: close

{
  "http_code": 200,
  "response_code": "SUCCESS",
  "response_msg": "",
  "data": {
    "folder": "inbox",
    "limit": "1000",
    "data": [
      {
        "message_id": "82469c20-8f97-4c72-9d2f-d8224d30722a",
        "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-08-04 12:11:28",
        "valid_until": "2021-08-11 12:11:28",
        "time_to_send": "2021-08-04 12:11:28",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": true,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ]
      },
      {
        "message_id": "5172aae1-f708-12ca-9115-2d202a084a13",
        "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-08-04 12:11:28",
        "valid_until": "2021-08-11 12:11:28",
        "time_to_send": "2021-08-04 12:11:28",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": true,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ]
      },
      {
        "message_id": "d5843a47-0ff6-ed10-8875-1c2e6ef8cefc",
        "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-08-04 12:11:28",
        "valid_until": "2021-08-11 12:11:28",
        "time_to_send": "2021-08-04 12:11:28",
        "submit_report_requested": true,
        "delivery_report_requested": true,
        "view_report_requested": true,
        "tags": [
          {
            "name": "Type",
            "value": "SMS:TEXT"
          }
        ]
      }
    ]
  }
}
    

Wie man SMS aus Tcl/Tk mit der Tcl/Tk-SMS-API sendet (Video-Tutorial)

Dieses Video zeigt Ihnen, wie Sie die Datei ReceiveSms.tcl.zip von dieser Seite herunterladen und wie Sie deren Inhalt in einem Texteditor öffnen. Wenn Sie das Video ansehen, werden Sie feststellen, dass der Inhalt der ReceiveSms.tcl-Zip-Datei auf den Desktop platziert wird. Sie werden auch sehen, dass wir doppelt auf die ReceiveSms.tcl-Datei klicken, um das Tcl-Skript zu öffnen.

Tcl/Tk-SMS-Beispiel: ReceiveSms.tcl

Der untenstehende Beispielcode ist Teil der Datei ReceiveSms.tcl.zip. In der Zip-Datei finden Sie zwei Dateien: ReceiveSms.tcl und die Ozeki.Libs.Rest.tcl.

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

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 aus der Ozeki SMS Gateway Management-Konsole öffnen. Das folgende Video zeigt Ihnen, worauf Sie achten müssen. Das Video beginnt mit dem geöffneten Code und endet mit den Details der gesendeten Nachricht. Sie lernen, wie Sie das Projekt starten, wie das Projekt während des Betriebs aussieht und wie die Protokolldatei danach aussieht. Das Video ist nur 42 Sekunden lang und leicht verständlich. Sie werden keine Probleme haben, ihm zu folgen.