C# vymazanie SMS zo SMS brány

Najjednoduchší spôsob, ako odoslať SMS z C#, je použiť vstavanú HTTP/Rest SMS API Ozeki SMS Gateway. Keď použijete toto API, budete odosielať SMS správy vytvorením HTTP POST požiadavky na SMS bránu. HTTP POST požiadavka bude obsahovať správu vo formáte JSON. SMS brána následne odošle túto SMS na cieľové telefónne číslo a vráti HTTP 200 OK odpoveď na vašu požiadavku.

Ukážka C# kódu pre SMS nižšie demonštruje, ako môžete prijímať SMS pomocou HTTP REST SMS API Ozeki SMS Gateway s použitím knižnice Ozeki.Libs.Rest pre C#. Táto knižnica je poskytovaná bezplatne a môžete ju používať a upravovať v akomkoľvek z vašich projektov.

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();
        }
    }
}

Ako použiť C# príklad pre SMS:

Tento C# príklad pre SMS môže byť použitý v akomkoľvek .NET alebo .NET Core aplikácii. Na jeho použitie musíte pridať Ozeki.Libs.Rest DLL ako referenciu do vášho projektu. Po pridaní referencie musíte vložiť direktívu using Ozeki.Libs.Rest; do hlavičkovej časti vášho C# zdrojového kódu. To vám umožní používať triedy poskytované knižnicou Ozeki.Libs.Rest. Môžete použiť triedu MessageApi na prijatie SMS zo SMS brány. SMS brána vám správu prepošle buď prostredníctvom bezdrôtového pripojenia alebo cez internet.

Zdrojový kód vysvetlený v tomto článku môže byť stiahnutý, použitý a upravený bezplatne.
Stiahnuť: DeleteSms.cs.zip (47.6Kb)

Súbor Delete-SMS.cs.zip obsahuje knižnicu Ozeki.Libs.Rest, ktorá vám poskytuje všetky potrebné nástroje na odosielanie, prijímanie a mazanie SMS správ. V zip súbore nájdete aj projekt DeleteSms, ktorý obsahuje ukážkový kód, ktorý vám ukáže, ako vymazať SMS. Tento ukážkový kód je uvedený nižšie.

Na vymazanie SMS pomocou C#:

1. Nainštalujte Visual Studio Community
2. Stiahnite súbor DeleteSms.cs.zip
3. Extrahujte .zip súbor zo stiahnutých súborov
4. Otvorte súbor DeleteSms.cs.sln v Visual Studio
5. Spustite Ozeki SMS Gateway
6. Vyberte http_user v karte Používatelia a aplikácie
7. Skontrolujte detaily správy v Doručenej pošte
8. Vložte ID SMS správy do kódu Program.cs
9. Spustite Program.cs na vymazanie SMS pomocou C#

Na odosielanie SMS z C# je potrebné najprv nainštalovať Ozeki SMS Gateway. SMS brána môže byť nainštalovaná na rovnakom počítači, kde vyvíjate svoj C# kód vo Visual Studio. Po inštalácii je ďalším krokom pripojenie Ozeki SMS Gateway k mobilnej sieti. Môžete odoslať testovaciu SMS z Ozeki GUI na overenie, či vaše mobilné pripojenie funguje. Posledným krokom na prípravu vášho prostredia je vytvorenie HTTP SMS API používateľského účtu. Vytvorte používateľa s menom "http_user" a heslom "qwe123", aby príklad fungoval bez úprav.

Po nastavení prostredia môžete spustiť svoj C# kód.

Na odosielanie SMS z C# bude vaša C# aplikácia musieť odoslať HTTP požiadavku na SMS bránu. API URL je uvedené nižšie. Upozorňujeme, že IP adresa (127.0.0.1) by mala byť nahradená IP adresou vašej SMS brány. Ak je Ozeki SMS Gateway nainštalovaná na rovnakom počítači, kde beží C# SMS aplikácia, môže to byť 127.0.0.1. Ak je nainštalovaná na inom počítači, mala by to byť IP adresa toho počítača.

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

Na autentifikáciu C# SMS klienta musíte odoslať používateľské meno a heslo v base64 kódovanom reťazci na server v HTTP požiadavke. Používa sa formát: base64(používateľské meno+":"+heslo). V C# môžete na toto kódovanie použiť nasledujúci kód:

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

Napríklad, ak zakódujete používateľské meno 'http_user' a heslo 'qwe123', dostanete nasledujúci base64 kódovaný reťazec: aHR0cF91c2VyOnF3ZTEyMw==. Na odoslanie

HTTP požiadavka na vymazanie SMS pomocou C#

Na vymazanie SMS bude vaša aplikácia v C# odosielať HTTP požiadavku podobnú ako je uvedená nižšie. Upozorňujeme, že táto požiadavka obsahuje časť HTTP hlavičky a časť HTTP tela. Telo HTTP je reťazec dát zakódovaný v JSON. Obsahuje číslo príjemcu a text sprá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"
	]
}
	

Na odoslanie SMS správ musíte do HTTP požiadavky zahrnúť nasledujúce riadky ako hlavičky. Upozorňujeme, že zaraďujeme typ obsahu a autorizačnú hlavičku.

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

Keď SMS brána prijme túto požiadavku, vygeneruje HTTP odpoveď. HTTP odpoveď bude obsahovať stavový kód, ktorý indikuje, či bola požiadavka na odoslanie SMS úspešná alebo nie. Tiež vráti štruktúru zakódovanú v JSON, ktorá vám poskytne užitočné informácie o odoslaní sprá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"
		]
	}
}
	

Toto video vám ukáže, ako vytvoriť nový projekt konzolovej aplikácie .Net core v Visual Studio, ako ho pomenovať na DeleteSms.sln. Keď je riešenie vytvorené, môžete si všimnúť, že sa do riešenia pridá DeleteSms.csproj, a štandardne sa otvorí súbor Program.cs. Môžete premenovať Program.cs na Program.cs, ak si budete priať. Tiež uvidíte vo videu, ako môže byť príkladový kód nižšie skopírovaný do súboru Program.cs a ako ho môžete skompilovať a spustiť.

V tomto videu sa naučíte, ako stiahnuť a spustiť príkladový projekt DeleteSms.sln. Video začne stránkou na stiahnutie a skončí otvoreným editorom kódu. Naučíte sa, ako stiahnuť a čo robiť so súborom projektu. Ukážeme vám, aký softvér potrebujete použiť. Toto video je dlhé len 1 minútu, ale je veľmi podrobné, takže nebudete mať problém s dodržaním krokov.

Príkladový kód nižšie je súčasťou riešenia Visual Studio DeleteSms.sln. Riešenie Visual Studio môže obsahovať viacero projektov a viacero súborov. V tomto riešení sú len dva projekty: DeleteSms.csproj, Ozeki.Libs.Rest.csproj a jeden súbor: Program.cs.

V ďalšom videu sa naučíte, ako spustiť príkladový kód a ako skontrolovať záznam procesu. Začne sa spustením Ozeki SMS Gateway a prevedie vás až k prázdnej doručenej pošte po vymazaní SMS. Naučíte sa, ako získať ID správy a ako použiť kód na vymazanie správy. Video je dlhé len 1:38 a obsahuje všetky informácie, ktoré potrebujete na vymazanie správy pomocou tohto projektu.

Keď použijete Windows na spustenie tohto príkladu SMS napísaného v C#, všimnete si, že dostanete mierne lepší výkon ako pri spustení na Linuxe. Aby ste pochopili, prečo sa to deje, musíte mať na pamäti, že C# používa na vykonávanie kódu framework .NET. Je to preto, lebo implementácia .NET na Windows je optimalizovaná pre výkon, zatiaľ čo mono, implementácia .NET na Linuxe, má v tejto oblasti nejaké dobiehanie.

Tento sprievodca vysvetlil kroky vymazania SMS z Ozeki SMS Gateway pomocou C#. Ak bol článok pozorne prečítaný, vymazanie správ z Ozeki SMS Gateway sa zdá naozaj jednoduché s kódom v C#. Toto riešenie dokonale ukazuje, ako jednoduché je ovládať a konfigurovať Ozeki SMS Gateway pomocou príkazov v C#. Ozeki SMS Gateway vám umožňuje spravovať náklady na SMS a sledovať prevádzku správ. S touto funkciou vymazania môžete rýchlo odstrániť nechcené správy.

Ak chcete pokračovať v čítaní, navštívte stránky s návodmi Ozeki, kde nájdete informácie o podobných témach, ako sú plánovanie SMS v C#.

Teraz už len stačí stiahnuť Ozeki SMS Gateway a nechať prácu začať!