C# smazání SMS ze SMS brány

Nejjednodušší způsob, jak odesílat SMS z C#, je použít vestavěné HTTP/Rest SMS API Ozeki SMS Gateway. Při použití tohoto API budete odesílat SMS zprávy pomocí HTTP Post požadavku na SMS bránu. HTTP Post požadavek bude obsahovat zprávu ve formátu JSON. SMS brána odešle tuto SMS na cílový telefon a vrátí HTTP 200 OK odpověď na váš požadavek.

jak smazat SMS ze SMS brány pomocí C#
Obrázek 1 - Jak smazat SMS ze SMS brány pomocí C#

C# kód pro příjem SMS z mobilu

Ukázkový kód v C# níže demonstruje, jak můžete přijímat SMS pomocí HTTP REST SMS API Ozeki SMS Gateway s využitím knihovny Ozeki.Libs.Rest v C#. Tato knihovna je poskytována zdarma a můžete ji používat a upravovat v jakémkoli svém projektu.

Program.cs 

using System;
using Ozeki.Libs.Rest;

namespace DeleteSms.cs
{
    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 msg = new Message()
            {
                ID = "a85d6e16-f888-4306-bd2a-8f8a119d8abf"
            };

            var api = new MessageApi(configuration);

            var result = api.Delete(Folder.Inbox, msg);

            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}

Jak použít ukázku SMS v C#:

Tato ukázka SMS v C# může být použita v jakékoli .NET nebo .NET core aplikaci. Pro její použití musíte přidat Ozeki.Libs.Rest DLL jako referenci do vašeho projektu. Po přidání reference do projektu musíte vložit direktivu using Ozeki.Libs.Rest; do hlavičkové části vašeho zdrojového kódu v C#. To vám umožní používat třídy poskytované knihovnou Ozeki.Libs.Rest. Můžete použít třídu MessageApi k příjmu SMS ze SMS brány. SMS brána přepošle zprávu buď přes bezdrátové připojení nebo přes internet.

Stáhnout Delete-SMS.cs

Zdrojový kód vysvětlený v tomto článku lze stáhnout, použít a upravit zdarma.
Stáhnout: DeleteSms.cs.zip (47.6Kb)

Co obsahuje soubor Delete-SMS.cs.zip?

Soubor Delete-SMS.cs.zip obsahuje knihovnu Ozeki.Libs.Rest, která vám poskytuje všechny nástroje potřebné k odesílání, příjmu a mazání SMS zpráv. V zipu také najdete projekt DeleteSms, který obsahuje ukázkový kód, který vám ukáže, jak smazat SMS. Tento ukázkový kód je uveden níže.

složka delete sms cs
Obrázek 2 - Co obsahuje Recive-SMS.cs.zip

Jak smazat SMS pomocí C# (Rychlé kroky)

Pro smazání SMS pomocí C#:

  1. Nastavte Visual Studio Community
  2. Stáhněte soubor DeleteSms.cs.zip
  3. Extrahujte .zip soubor ze složky Stažené
  4. Otevřete soubor DeleteSms.cs.sln v Visual Studiu
  5. Spusťte Ozeki SMS Gateway
  6. Vyberte http_user v záložce Uživatelé a aplikace
  7. Zkontrolujte detaily zprávy v Doručené poště
  8. Vložte ID SMS zprávy do kódu Program.cs
  9. Spusťte Program.cs pro smazání SMS pomocí C#

Instalace Ozeki SMS Gateway a vytvoření HTTP API uživatele

Abyste mohli odesílat SMS z C#, musíte nejprve nainstalovat Ozeki SMS Gateway. SMS brána může být nainstalována na stejném počítači, kde vyvíjíte svůj C# kód ve Visual Studiu. Po instalaci je dalším krokem připojení Ozeki SMS Gateway k mobilní síti. Můžete odeslat testovací SMS z Ozeki GUI pro ověření, že vaše připojení k mobilní síti funguje. Posledním krokem k přípravě vašeho prostředí je vytvoření HTTP SMS API uživatelského účtu. Vytvořte uživatele s uživatelským jménem "http_user" a heslem "qwe123", aby ukázka fungovala bez úprav.

Po nastavení prostředí můžete spustit svůj C# kód.

HTTP API URL pro odesílání SMS z C#

Pro odesílání SMS z C# bude vaše C# aplikace muset odeslat HTTP požadavek na SMS bránu. API URL je uvedeno níže. Poznámka: IP adresa (127.0.0.1) by měla být nahrazena IP adresou vaší SMS brány. Pokud je Ozeki SMS Gateway nainstalována na stejném počítači, kde běží C# SMS aplikace, může to být 127.0.0.1. Pokud je nainstalována na jiném počítači, měla by být použita IP adresa tohoto počítače. 

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

HTTP autentizace pro příjem SMS z C#

Pro autentizaci C# SMS klienta musíte odeslat uživatelské jméno a heslo v base64 kódovaném řetězci na server v HTTP požadavku. Použitý formát je: base64(username+":"+password). V C# můžete použít následující kód pro toto kódování: 

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

Například pokud zakódujete uživatelské jméno 'http_user' a heslo 'qwe123', získáte následující base64 kódovaný řetězec: aHR0cF91c2VyOnF3ZTEyMw==. Pro odeslání

HTTP požadavek na smazání SMS v C#

Pro smazání SMS bude vaše aplikace v C# odesílat HTTP požadavek podobný tomu níže. Všimněte si, že tento požadavek obsahuje část HTTP hlavičky a část HTTP těla. Tělo HTTP je řetězec dat zakódovaný v JSON. Obsahuje číslo příjemce a text zprávy. 

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
 
{
	"folder":  "inbox",
	"message_ids":
	[
		"3a922414-458f-4866-a8ee-f053d1132a6b"
	]
}

HTTP hlavička požadavku pro smazání SMS z C#

Pro odeslání SMS zpráv je třeba do HTTP požadavku zahrnout následující řádky jako hlavičky. Všimněte si, že zahrnujeme typ obsahu a autorizační hlavičku. 

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

HTTP odpověď přijatá příkladem SMS v C#

Jakmile SMS brána obdrží tento požadavek, vygeneruje HTTP odpověď. HTTP odpověď bude obsahovat stavový kód, který indikuje, zda byl požadavek na odeslání SMS úspěšný nebo ne. Vrátí také strukturu zakódovanou v JSON, která vám poskytne užitečné podrobnosti o odeslání zprávy. 

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",
		"message_ids": [
			"3a922414-458f-4866-a8ee-f053d1132a6b"
		]
	}
}

Jak smazat SMS v C# pomocí SMS API v C# (Video návod)

Toto video vám ukáže, jak vytvořit nový projekt konzolové aplikace .Net core v Visual Studiu, jak jej pojmenovat na DeleteSms.sln. Jakmile je řešení vytvořeno, můžete si všimnout, že do řešení je přidán DeleteSms.csproj a ve výchozím nastavení je otevřen soubor Program.cs. Soubor Program.cs můžete přejmenovat na Program.cs, pokud si přejete. Ve videu uvidíte také, jak lze níže uvedený příklad kódu zkopírovat do souboru Program.cs a jak jej lze zkompilovat a spustit.

Příklad SMS v C#: DeleteSms.sln


Jak stáhnout soubor projektu (Video návod)

V tomto videu se naučíte, jak stáhnout a spustit příklad projektu DeleteSms.sln. Video začíná na stránce stahování a končí otevřeným editorem kódu. Dozvíte se, jak stáhnout a co dělat se souborem projektu. Ukážeme vám, jaký software potřebujete použít. Toto video je dlouhé pouze 1 minutu, ale je velmi podrobné, takže nebudete mít problém s následováním kroků.

Video 1 - Jak stáhnout a spustit příklad řešení (Video návod)

Níže uvedený příklad kódu je součástí řešení Visual Studio DeleteSms.sln. Řešení Visual Studio může obsahovat více projektů a více souborů. V tomto řešení jsou pouze dva projekty: DeleteSms.csproj, Ozeki.Libs.Rest.csproj a jeden soubor: Program.cs.

Obrázek 3 - DeleteSms.sln

Jak používat projekt (Video návod)

V dalším videu se naučíte, jak spustit příkladový kód a jak zkontrolovat log procesu. Začne se spuštěním Ozeki SMS Gateway a dovede vás až k prázdné doručené poště po smazání SMS. Dozvíte se, jak získat ID zprávy a jak použít kód k smazání zprávy. Video je dlouhé pouze 1:38 a obsahuje všechny informace, které potřebujete k smazání zprávy pomocí tohoto projektu.

Video 2 - Jak smazat SMS pomocí výše uvedeného kódu v C# (Video návod)

Spuštění příkladu SMS v C# na Windows

Když použijete Windows pro spuštění tohoto příkladu SMS napsaného v C#, všimnete si, že získáte o něco lepší výkon než při spuštění na Linuxu. Abyste pochopili, proč k tomu dochází, musíte mít na paměti, že C# používá pro spouštění kódu framework .NET. Je to proto, že implementace .NET na Windows je optimalizována pro výkon, zatímco mono, implementace .NET na Linuxu, má v této oblasti ještě co dohánět.

Shrnutí

Tento průvodce vysvětluje kroky pro smazání SMS z Ozeki SMS Gateway pomocí C#. Pokud byl článek pečlivě přečten, mazání zpráv z Ozeki SMS Gateway se zdá s kódem v C# opravdu snadné. Toto řešení dokonale ukazuje, jak jednoduché je ovládat a konfigurovat Ozeki SMS Gateway pomocí příkazů v C#. Ozeki SMS Gateway vám umožňuje spravovat náklady na SMS a sledovat provoz zpráv. S touto funkcí mazání můžete rychle odstranit nechtěné zprávy.

Chcete-li pokračovat ve čtení, navštivte stránky s návody Ozeki, kde najdete informace o podobných tématech, jako je plánování SMS v C#.

Jediné, co teď musíte udělat, je stáhnout Ozeki SMS Gateway a nechat práci začít!

More information