Wie man SMS in C# empfängt
Der einfachste Weg, SMS von C# 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 wird eine Nachricht im JSON-Format enthalten. Das SMS-Gateway wird diese SMS an das Empfängertelefon senden und eine HTTP-200-OK-Antwort auf Ihre Anfrage zurückgeben.
C#-Code zum Empfangen von SMS von einem Mobiltelefon
Das folgende C#-SMS-Codebeispiel zeigt, wie Sie SMS mit der HTTP-Rest-SMS-API von Ozeki SMS Gateway unter Verwendung der C#-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.csusing Ozeki.Libs.Rest; using System; namespace ReceiveSms { class Program { static void Main(string[] args) { var configuration = new Configuration() { Username = "http_user", Password = "qwe123", ApiUrl = "http://127.0.0.1:9509/api" }; var api = new MessageApi(configuration); var messages = api.DownloadIncoming(); Console.WriteLine(messages.Length + " Nachrichten wurden aus dem Posteingang heruntergeladen."); foreach(Message msg in messages) { Console.WriteLine(msg); }; Console.ReadKey(); } } }
Wie man das C#-SMS-Beispiel verwendet:
Dieses C#-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 "using Ozeki.Libs.Rest;" in den Header-Bereich Ihres C#-Quellcodes einfügen. Dies ermöglicht Ihnen die Verwendung der Klassen der Ozeki.Libs.Rest-Bibliothek. Sie können die MessageApi-Klasse verwenden, um die SMS vom SMS-Gateway zu empfangen. Das SMS-Gateway wird die Nachricht entweder über eine drahtlose Verbindung oder über das Internet an Sie weiterleiten.
ReceiveSms.cs herunterladen
Der in diesem Artikel erklärte Quellcode kann kostenlos heruntergeladen, verwendet und modifiziert werden.
Download: ReceiveSms.cs.zip (33,8Kb)
Was befindet sich in der Datei ReceiveSms.cs.zip?
Die Datei ReceiveSms.cs.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 empfangen können. Dieser Beispielcode ist unten aufgeführt.
Wie man SMS in C# empfängt (Einfache Anleitung)
Um SMS in C# zu empfangen:
- Richten Sie Visual Studio Community ein
- Laden Sie die Datei ReceiveSms.cs.zip herunter
- Entpacken Sie die .zip-Datei aus dem Downloads-Ordner
- Öffnen Sie die Datei ReceiveSms.sln in Visual Studio
- Starten Sie Ozeki SMS Gateway
- Klicken Sie im Tab "Benutzer und Anwendungen" auf HTTP-Benutzer
- Führen Sie Program.cs aus, um SMS in C# zu empfangen
- Überprüfen Sie den Posteingang in Ozeki SMS Gateway
Ozeki SMS Gateway installieren und einen HTTP-API-Benutzer erstellen
Um SMS von C# aus senden und 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 C#-Code in Visual Studio entwickeln. Nach der Installation ist der nächste Schritt, Ozeki SMS Gateway mit dem Mobilfunknetz zu verbinden. Sie können 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 C#-Code ausführen.
HTTP-API-URL zum Empfangen von SMS in C#
Um SMS von C# aus zu senden, muss Ihre C#-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 C#-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 in C#
Um den C#-SMS-Client zu authentifizieren, müssen Sie den Benutzernamen und das Passwort in einer base64-kodierten Zeichenkode 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 die folgende base64-kodierte Zeichenkode: aHR0cF91c2VyOnF3ZTEyMw==. Um zu senden
HTTP-Anfrage zum Empfangen von SMS mit C#
Um SMS zu empfangen, sendet Ihre C#-Anwendung eine HTTP-Anfrage ähnlich der untenstehenden. 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-Anfrageheader zum Empfangen von SMS aus C#
Um die SMS-Nachrichten zu senden, müssen Sie die folgenden Zeilen als Header in die HTTP-Anfrage aufnehmen. Beachten Sie, dass wir einen Content-Type und einen Authorization-Header einfügen.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
HTTP-Antwort, die vom C#-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-Sendeanfrage erfolgreich war oder nicht. Sie gibt auch eine JSON-kodierte Struktur zurück, die Ihnen nützliche Details über den Versand 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: Mon, 07 Jun 2021 14:10:25 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": "b754195d-9bd8-48dc-a45f-cf688c5b32e3", "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-06-08 09:12:24", "valid_until": "2021-06-15 09:12:24", "time_to_send": "0001-01-01 00:00:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": true, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ] }, { "message_id": "a6337c23-51bc-43ee-9181-c9838abbe161", "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-08 09:12:24", "valid_until": "2021-06-15 09:12:24", "time_to_send": "0001-01-01 00:00:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": true, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ] }, { "message_id": "ca14710b-42b9-4abc-b04f-262cc282dd7c", "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-08 09:12:24", "valid_until": "2021-06-15 09:12:24", "time_to_send": "0001-01-01 00:00:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": true, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ] } ] } }
Wie man SMS mit C# empfängt, indem man die C#-SMS-API verwendet (Video-Tutorial)
Dieses Video zeigt Ihnen, wie Sie ein neues .Net Core-Konsolenprojekt in Visual Studio erstellen und es ReceiveSms.sln nennen. Sobald die Lösung erstellt ist, werden Sie feststellen, dass ein Receive-SMS.csproj zur Lösung hinzugefügt wurde und standardmäßig die Datei Program.cs geöffnet ist. Sie können die Program.cs in ReceiveSMS.cs umbenennen, wenn Sie möchten. Sie werden auch im Video sehen, wie der Beispielcode unten in die Program.cs-Datei kopiert werden kann und wie er kompiliert und ausgeführt werden kann.
C#-SMS-Beispiel: ReceiveSms.sln
Wie man das Beispielprojekt herunterlädt und ausführt (Video-Tutorial)
In diesem Video lernen Sie, wie Sie das Beispielprojekt ReceiveSMS.sln herunterladen und ausführen. Das Video beginnt mit der Download-Seite und endet mit dem geöffneten Code-Editor. Sie lernen, wie Sie herunterladen und wo Sie Ihr Beispielprojekt finden. Außerdem zeigen wir Ihnen, wie Sie das heruntergeladene Projekt öffnen. Dieses Video ist nur 1 Minute lang, aber sehr detailliert, sodass Sie keine Probleme haben werden, den Schritten zu folgen.
Der Beispielcode unten ist Teil der ReceiveSms.sln Visual Studio-Lösung. Eine Visual Studio-Lösung kann mehrere Projekte und mehrere Dateien enthalten. In dieser Lösung gibt es nur ein Projekt: ReceiveSms.csproj und eine Datei: Program.cs.
Wie man den Code verwendet (Video-Tutorial)
Im nächsten Video lernen Sie, wie Sie den Beispielcode ausführen und das Protokoll des Prozesses überprüfen. Es beginnt mit dem Starten des Ozeki SMS Gateways und führt Sie bis zum Ereignis-Tab. Sie lernen, wie Sie das Protokoll überprüfen, wie Sie Ihren Code ausführen und wie Sie die empfangenen Nachrichten überprüfen. Das Video ist nur 1 Minute lang, enthält aber alle notwendigen Informationen, die Sie benötigen, um das ReceiveSMS.sln-Projekt zu verwenden.
Ausführen des C# SMS-Beispiels unter Windows
Wenn Sie Windows verwenden, um dieses in C# geschriebene SMS-Beispiel auszuführen, werden Sie feststellen, dass die Leistung etwas besser ist als unter Linux. Um zu verstehen, warum dies passiert, müssen Sie bedenken, dass C# das .NET-Framework für die Codeausführung nutzt. 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 aufholen muss.
Fazit
Dieser Artikel zeigte die notwendigen Schritte zum Empfangen von SMS in C#. Mit dieser Anleitung und dem Ozeki SMS Gateway ist das Empfangen von SMS in C# kein Problem mehr. Studieren Sie die Anleitung sorgfältig und Sie werden diese Schritte leicht durchführen können. Das Ozeki SMS Gateway ist in diesem Verfahren entscheidend, da es als Verbindung zwischen Mobilfunknutzern und Ihnen dient. Die Tatsache, dass das Ozeki SMS Gateway in einer Umgebung läuft, die Sie kontrollieren, muss hervorgehoben werden, da dies bedeutet, dass Ihre Kontaktliste und Daten sicher sind.
Lesen Sie weiter auf der Tutorial-Seite von Ozeki, wo Sie weitere Anleitungen zu Themen wie Terminierung aus C# finden.
Laden Sie das Ozeki SMS Gateway jetzt herunter und legen Sie los!
More information