C# SMS törlése az SMS gateway-ből

A legegyszerűbb módja SMS küldésének C#-ból a beépített HTTP/Rest SMS API használata az Ozeki SMS Gateway-ben. Amikor ezt az API-t használod, SMS üzeneteket küldhetsz egy HTTP POST kérés kiadásával az SMS gateway felé. A HTTP POST kérés egy JSON formátumban formázott üzenetet fog tartalmazni. Az SMS gateway elküldi ezt az SMS-t a címzett telefonnak, és egy HTTP 200 OK választ fog visszaadni a kérésedre.

SMS törlése az SMS gateway-ből C# használatával
1. ábra - SMS törlése az SMS gateway-ből C# használatával

C# kód SMS fogadására mobilról

Az alábbi C# SMS kód minta bemutatja, hogyan fogadhatsz SMS-t az Ozeki SMS Gateway http rest sms api-ját használva a C# Ozeki.Libs.Rest könyvtár segítségével. Ez a könyvtár ingyenesen elérhető számodra, és bármely projektben felhasználhatod és módosíthatod.

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

A C# SMS példa használata:

Ez a C# SMS példa bármely .NET vagy .NET core alkalmazásban használható. A használatához hozzá kell adnod az Ozeki.Libs.Rest dll-t referenciaként a projektedhez. Miután a projekt referenca hozzáadva, be kell illesztened a using Ozeki.Libs.Rest; direktívát a C# forráskódod fejléc részébe. Ez lehetővé teszi számodra az Ozeki.Libs.Rest könyvtár által nyújtott osztályok használatát. A MessageApi osztály segítségével fogadhatod az SMS-t az SMS gateway-től. Az SMS gateway továbbítja az üzenetet neked vezeték nélküli kapcsolaton vagy az interneten keresztül.

Delete-SMS.cs letöltése

A cikkben ismertetett forráskód letölthető, felhasználható és módosítható ingyenesen.
Letöltés: DeleteSms.cs.zip (47.6Kb)

Mi található a Delete-SMS.cs.zip fájlban?

A Delete-SMS.cs.zip fájl tartalmazza az Ozeki.Libs.Rest könyvtárat, amely minden szükséges eszközt nyújt SMS üzenetek küldéséhez, fogadásához és törléséhez. A zip fájlban megtalálod a DeleteSms projektet is, amely tartalmazza a példakódot, amely bemutatja hogyan törölhetsz egy SMS-t. Ez a példakód alább látható.

delete sms cs directory
2. ábra - Mi található a Recive-SMS.cs.zip fájlban

Hogyan törölj SMS-t C# használatával (Gyors lépések)

SMS törlése C# használatával:

  1. Állítsd be a Visual Studio Community-t
  2. Töltsd le a DeleteSms.cs.zip fájlt
  3. Csomagold ki a .zip fájlt a Letöltésekből
  4. Nyisd meg a DeleteSms.cs.sln fájlt a Visual Studio-ban
  5. Indítsd el az Ozeki SMS Gateway-t
  6. Válaszd ki a http_user-t a Felhasználók és alkalmazások lapon
  7. Ellenőrizd az üzenet részleteit a Beérkezett üzenetekben
  8. Illeszd be az SMS üzenet azonosítóját a Program.cs kódba
  9. Futtasd a Program.cs-t SMS törléséhez C#-ban

Ozeki SMS Gateway telepítése és HTTP API felhasználó létrehozása

Ahhoz, hogy SMS-t tudj küldeni C#-ból, először telepítened kell az Ozeki SMS Gateway-t. Az SMS gateway telepíthető ugyanarra a számítógépre, ahol a C# kódodat fejleszted a Visual Studio-ban. Telepítés után a következő lépés az Ozeki SMS Gateway csatlakoztatása a mobil hálózathoz. Küldhetsz egy teszt SMS-t az Ozeki GUI-ból annak ellenőrzésére, hogy a mobil hálózati kapcsolatod működik. A környezet előkészítésének utolsó lépése az HTTP sms api felhasználói fiók létrehozása. Hozz létre egy felhasználót "http_user" felhasználónévvel és "qwe123" jelszóval, hogy a példa módosítás nélkül működjön.

Miután a környezet beállításra került, futtathatod a C# kódodat.

HTTP API URL SMS küldéséhez C#-ból

Ahhoz, hogy SMS-t küldj C#-ból, a C# alkalmazásodnak HTTP kérést kell küldenie az SMS gateway felé. Az API URL alább látható. Fontos, hogy az IP cím (127.0.0.1) helyére az SMS gateway IP címét kell beírnod. Ha az Ozeki SMS Gateway ugyanarra a számítógépre van telepítve, ahol a C# SMS alkalmazás fut, ez lehet 127.0.0.1. Ha másik számítógépre van telepítve, akkor annak a számítógépnek az IP címét kell megadnod. 

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

HTTP hitelesítés SMS fogadásához C#-ból

A C# SMS kliens hitelesítéséhez a felhasználónevet és a jelszót egy base64 kódolt sztringben kell elküldened a szervernek egy HTTP kérésben. A használt formátum: base64(username+":"+password). C#-ban a következő kódot használhatod ehhez a kódoláshoz: 

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

Például ha a 'http_user' felhasználónevet és a 'qwe123' jelszót kódolod, a következő base64 kódolt sztringet kapod: aHR0cF91c2VyOnF3ZTEyMw==. A küldéshez

HTTP kérés SMS törléséhez C#-ban

Ahhoz, hogy SMS-t törölj, a C# alkalmazásod egy HTTP kérést fog küldeni, hasonlóan az alábbihoz. Figyelj rá, hogy ez a kérés tartalmaz egy HTTP fejléc részt és egy http törzs részt. A HTTP törzs egy JSON kódolt adatsztring. Tartalmazza a címzett számát és az üzenet szövegét. 

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 kérés fejléc SMS törléséhez C#-ból

Az SMS üzenetek küldéséhez a következő sorokat kell fejlécben tartalmaznia a HTTP kérésnek. Figyelj rá, hogy tartalmazunk egy content type és egy Authorization fejlécet. 

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

HTTP válasz, amit a C# SMS példa kap

Amint az SMS gateway megkapja ezt a kérést, generál egy HTTP választ. A HTTP válasz tartalmaz egy státusz kódot, jelezve, hogy az SMS beküldési kérés sikeres volt-e vagy sem. Egy JSON kódolt struktúrát is visszaad, hogy hasznos részleteket nyújtson az üzenet beküldéséről. 

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"
		]
	}
}

Hogyan törölj SMS-t C#-ban a C# SMS API használatával (Videó útmutató)

Ez a videó bemutatja, hogyan hozhatsz létre egy új .Net core konzol projektet a Visual Studio-ban, hogyan nevezd át DeleteSms.sln-re. Miután a megoldás létrejött, észreveheted, hogy egy DeleteSms.csproj hozzáadódik a megoldáshoz, és alapértelmezés szerint a Program.cs fájl nyílik meg. Átnevezheted a Program.cs fájlt Program.cs-re, ha szeretnéd. A videóban azt is látni fogod, hogyan másolható be az alábbi példakód a Program.cs fájlba, és hogyan fordítható és futtatható.

C# SMS példa: DeleteSms.sln


Hogyan töltsd le a projektfájlt (Videó útmutató)

Ebben a videóban megtanulod, hogyan töltsd le és futtasd a DeleteSms.sln példaprojektet. A videó a letöltési oldallal kezdődik és a megnyitott kódszerkesztővel ér véget. Megtanulod, hogyan töltsd le és mit kezdj a projektfájllal. Megmutatjuk, milyen szoftverre van szükséged. Ez a videó csak 1 perc hosszú, de nagyon részletes, így nem lesz gondod a lépések követésével.

1. videó - Hogyan töltsd le és futtasd a példa megoldást (Videó útmutató)

Az alábbi példakód a DeleteSms.sln Visual Studio Megoldás része. Egy visual studio megoldás több projektet és több fájlt is tartalmazhat. Ebben a megoldásban csak két projekt található: DeleteSms.csproj, Ozeki.Libs.Rest.csproj és egy fájl: Program.cs.

3. ábra - DeleteSms.sln

Hogyan használd a projektet (Videó útmutató)

A következő videóban megtanulod, hogyan futtasd a példakódot és hogyan ellenőrizd a folyamat naplóját. Az Ozeki SMS Gateway elindításával kezdődik és egészen az üres beérkezett üzenetek mappáig vezet, miután törölted az SMS-t. Megtanulod, hogyan kell megszerezni az üzenet azonosítóját és hogyan használd a kódot egy üzenet törléséhez. A videó csak 1:38 perc hosszú és tartalmaz minden információt, amire szükséged van egy üzenet törléséhez ezzel a projekttel.

2. videó - Hogyan törölj SMS-t a fenti C# kóddal (Videó útmutató)

A C# SMS példa futtatása Windows-on

Amikor Windowst használsz a C#-ban írt SMS példa futtatásához, észreveheted, hogy kissé jobb teljesítményt kapsz, mint Linuxon való futtatáskor. Ennek megértéséhez szem előtt kell tartanod, hogy a C# a .NET keretrendszert használja a kód végrehajtásához. Ez azért van, mert a .NET implementáció Windowson optimalizált teljesítményre, míg a mono, a .NET implementáció Linuxon még némi utolérést igényel ezen a területen.

Összefoglalás

Az útmutató elmagyarázta az SMS törlésének lépéseit az Ozeki SMS Gateway-ből C# használatával. Ha figyelmesen elolvastad a cikket, az üzenetek törlése az Ozeki SMS Gateway-ből nagyon egyszerűnek tűnik egy C# kóddal. Ez a megoldás tökéletesen bemutatja, milyen egyszerű vezérelni és konfigurálni az Ozeki SMS Gateway-t C# parancsokkal. Az Ozeki SMS Gateway lehetővé teszi az SMS költségek kezelését és az üzenetforgalom nyomon követését. Ezzel a törlési funkcióval gyorsan eltávolíthatod a nemkívánatos üzeneteket.

A további olvasáshoz látogass el az Ozeki oktatóoldalaira, ahol hasonló témákról találsz információt, mint például SMS ütemezése C#-ban.

Most már csak annyi a dolgod, hogy letöltöd az Ozeki SMS Gateway-t és megkezdheted a munkát!

More information