Hogyan töröljünk SMS-t Visual Basic nyelven

A legegyszerűbb módja az SMS-ek törlésének Visual Basic nyelven az Ozeki SMS Gateway beépített HTTP/Rest SMS API-jának használata. Amikor ezt az API-t használod, HTTP POST kérést küldesz az SMS gateway-nek. A HTTP POST kérés egy JSON formátumban formázott üzenetet tartalmaz. Az SMS gateway elküldi ezt az SMS-t a címzett telefonszámára, és egy HTTP 200 OK választ küld vissza a kérésedre.

Visual Basic kód SMS törléséhez

Az alábbi Visual Basic SMS kódminta bemutatja, hogyan törölhetsz SMS-eket az Ozeki SMS Gateway HTTP REST SMS API-jával, az Ozeki.Libs.Rest könyvtár segítségével. Ez a könyvtár ingyenesen elérhető, és bármely projektjében felhasználhatod és módosíthatod.

Imports Ozeki.Libs.Rest

Module ReceiveSMS
    Sub Main(args As String())

        Dim configuration As New Configuration
        configuration.Username = "http_user"
        configuration.Password = "qwe123"
        configuration.ApiUrl = "http://127.0.0.1:9509/api"

        Dim msg As New Message
        msg.ID = "69022e7a-305c-4f01-8063-7f9d65f5ca49"
        //Ezt lecserélheted annak az üzenetnek az azonosítójára, amit törölni szeretnél

        Dim api As New MessageApi(configuration)

        Dim result = api.Delete(Folder.Inbox, msg)

        Console.WriteLine(result)
        Console.ReadKey()

    End Sub
End Module
	

A Visual Basic SMS példa használata:

Ez a Visual Basic SMS példa bármely .NET vagy .NET core alkalmazásban használható. A használatához az Ozeki.Libs.Rest DLL-t referenciaként hozzá kell adnod a projektedhez. A projekt referenciák hozzáadása után az "Imports Ozeki.Libs.Rest" direktívát kell elhelyezned a Visual Basic forráskódod fejléc részébe. Ez lehetővé teszi az Ozeki.Libs.Rest könyvtár által nyújtott osztályok használatát. A MessageApi osztály segítségével törölheted az SMS-eket az SMS gateway-ből.

DeleteSms.vb letöltése

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

Mi található a DeleteSms.vb.zip fájlban?

A DeleteSms.vb.zip fájl tartalmazza az Ozeki.Libs.Rest könyvtárat, amely minden szükséges eszközt biztosít az SMS-ek küldéséhez, jelöléséhez, törléséhez és fogadásához. A zip fájlban megtalálod a DeleteSms projektet is, amely tartalmazza a példakódot, amely bemutatja, hogyan küldj SMS-t. Ez a példakód az alábbiakban látható.

Hogyan töröljünk SMS-t Visual Basic nyelven (Gyors lépések)

Az SMS törlése Visual Basic nyelven:

1. Telepítsd az Ozeki SMS Gateway-t
2. Kapcsold az Ozeki SMS Gateway-t a mobil hálózathoz
3. Küldj egy teszt SMS-t az Ozeki GUI-ból
4. Hozz létre egy HTTP SMS API felhasználót
5. Indítsd el a Visual Studio-t
6. Hozz létre egy DeleteSms.sln nevű megoldást
7. Adj hozzá egy Visual Basic konzol projektet: DeleteSms.vbproj
8. Helyezd el a kódot a Program.vb vagy DeleteSms.vb fájlban
9. Hozz létre egy HTTP kérést az SMS törléséhez
10. Olvasd el a HTTP választ
11. Írd ki a választ a konzolra
12. Ellenőrizd a naplókat az SMS gateway-ben

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

Ahhoz, hogy SMS-eket törölhess Visual Basic nyelven, 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 Visual Basic kódodat fejleszted a Visual Studio-ban. A 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 kapcsolat működik-e. A környezet előkészítésének utolsó lépése egy HTTP SMS API felhasználó 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.

A környezet beállítása után futtathatod a Visual Basic kódodat.

HTTP API URL az SMS fogadásához Visual Basic nyelven

Ahhoz, hogy SMS-eket törölhess Visual Basic nyelven, a Visual Basic alkalmazásodnak HTTP kérést kell küldenie az SMS gateway-nek. Az API URL az alábbiakban látható. Fontos, hogy az IP cím (127.0.0.1) helyére az SMS gateway IP címét írd. Ha az Ozeki SMS Gateway ugyanarra a számítógépre van telepítve, ahol a Visual Basic SMS alkalmazás fut, ez maradhat 127.0.0.1. Ha másik számítógépre van telepítve, annak az IP címét kell megadni.

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

HTTP hitelesítés az SMS törléséhez Visual Basic nyelven

A Visual Basic SMS kliens hitelesítéséhez a felhasználónevet és a jelszót egy base64 kódolt karakterláncban kell elküldeni a szervernek egy HTTP kérésben. A formátum: base64(felhasználónév+":"+jelszó). C# nyelven a következő kódot használhatod 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 karakterláncot kapod: aHR0cF91c2VyOnF3ZTEyMw==.

HTTP kérés fejléc az SMS törléséhez Visual Basic nyelven

Az SMS üzenetek törléséhez a következő sorokat kell fejlécben szerepeltetni a HTTP kérésben. Figyelj arra, hogy a tartalomtípus és az Authorization fejléc is szerepel.

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

HTTP kérés SMS törléséhez Visual Basic nyelven

Az SMS törléséhez a Visual Basic alkalmazásod egy olyan HTTP kérést küld, mint az alábbi. 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 adatsor. Tartalmazza a mappa nevét és az üzenetek azonosítóit.

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":	[
		"69022e7a-305c-4f01-8063-7f9d65f5ca49"
		]
}
	

HTTP válasz a Visual Basic SMS példa által kapott

Amint az SMS gateway megkapja ezt a kérést, generál egy HTTP választ. A HTTP válasz tartalmaz egy státuszkódot, amely jelzi, hogy az SMS beküldési kérés sikeres volt-e vagy sem. Ezen kívül egy JSON kódolt struktúrát is visszaad, amely hasznos információkat nyújt 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: Thu, 10 Jun 2021 11:02:26 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "",
    "data": {
      "folder": "inbox",
      "message_ids": [
        "69022e7a-305c-4f01-8063-7f9d65f5ca49"
      ]
    }
}
	

Visual Basic SMS példa: DeleteSms.sln

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

Ebben a videóban megtanulhatod, hogyan töltsd le és futtasd a DeleteSms.sln példaprojektet. A videó a letöltési oldallal kezdődik, és a megnyitott projekttel ér véget. Megmutatjuk, hogyan töltsd le és nyisd meg a projektfájlt. A videó mindössze 58 másodperc hosszú, de tartalmazza az összes szükséges információt a feladat elvégzéséhez. A letöltési folyamatot az útmutató oldalról indíthatod el.

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.vbproj, Ozeki.Libs.Rest.csproj, és egy fájl: Program.vb.

Hogyan használd a példaprojektet (Videó útmutató)

A következő videóban megtanulhatod, 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ájáig vezet, ahonnan az üzenetek törlődtek. Megtanulod, hogyan ellenőrizd a napló oldalt és hogyan szerezd meg az üzenet azonosítóját, amelyre a törlési folyamathoz szükséged van. A videó mindössze 1 perc hosszú és nagyon részletes. A megtekintése után önállóan is el tudod végezni a feladatot. Az Ozeki SMS Gateway-t használjuk az Események lap megtekintéséhez és az üzenetek részleteinek megtekintéséhez. Az Ozeki SMS Gateway kiváló felhasználói élményt nyújt a nagyon intuitív felület és a sokoldalúság miatt.

A Visual Basic SMS példa futtatása Windows-on

Amikor Windows-on futtatod ezt az Visual Basic nyelven írt SMS példát, észreveheted, hogy kissé jobb teljesítményt kapsz, mint Linux-on történő futtatáskor. Ennek megértéséhez érdemes figyelembe venni, hogy a Visual Basic a .NET keretrendszert használja a kód végrehajtásához. Ez azért van, mert a .NET Windows-on optimalizált teljesítményre, míg a Linux-on használt mono, a .NET implementációja ezen a területen még fejlődik.

Összegzés

A fenti útmutató bemutatta az SMS-ek törlésének lépéseit VB nyelven az Ozeki SMS Gateway segítségével. Ha figyelmesen elolvastad a leírást, a nemkívánatos üzenetek eltávolítása a beérkezett üzeneteid közül nagyon egyszerű lehet. Az Ozeki SMS Gateway nagyon megbízható és könnyen kezelhető, még akkor is, ha VB kódokkal szeretnéd irányítani a programot.

Nagyon fontos az SMS-ek törlése a beérkezett üzenetek mappából a tárhely megtakarítása érdekében. A VB ismerete segít ennek a folyamatnak a megértésében, de amint láthattad, még a VB programozásban kezdők számára sem nehéz eljárás.

Ne fejezd be itt az olvasást, további témákról, például SMS ütemezésről és SMS fogadásról VB nyelven az Ozeki útmutató oldalán olvashatsz.

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