Hogyan küldjünk SMS-t C# nyelven HTTP-n keresztül

Egyszerűen létrehozhat egy C# konzolalkalmazást, amely lehetővé teszi, hogy HTTP kérést küldjön az Ozeki 10 SMS gateway-nek. Amikor futtatja ezt a mellékelt alkalmazást, először kiírja a HTTP kérést a konzolra, majd elküldi azt. Ha minden rendben megy, az Ozeki 10 SMS gateway megkapja ezt a kérést és visszaküld egy választ. A C# alkalmazásunk megkapja ezt a választ és megjeleníti a konzolon. Ebből a válaszból megtudhatjuk, hogy a kézbesítés sikeres volt-e.

Mi az a C# SMS API?

A C# SMS API egy nagyszerű eszköz, amely lehetővé teszi SMS üzenetek küldését bármilyen C# alapú projektből vagy alkalmazásból HTTP kérések kezdeményezésével és továbbításával az SMS Gateway felé.

Előfeltételek

SMS küldése C#-ból

Ha SMS-t szeretne küldeni C#-ból, használhatja az Ozeki SMS Gateway HTTP SMS API-ját.

SMS küldése C#-ból:

  1. Nyissa meg a https://localhost:9515 címet a böngészőjében és jelentkezzen be
  2. Hozzon létre egy új HTTP API felhasználót
  3. Ellenőrizze a HTTP API szolgáltatás portszámát
  4. Indítsa el a Visual Studio-t
  5. Hozzon létre egy új C# konzolprojektet
  6. Küldjön SMS-t C#-ból az alábbi forráskód beírásával
  7. Futtassa a Konzolalkalmazás projektet
  8. Nézze meg a C# projektjéből küldött SMS-t a mobiltelefonján

Hogyan küldjünk SMS-t C#-ból videó

1. videó - Hogyan küldjünk SMS-t C#-ból videó (Videó útmutató)

C# SMS forráskód példa

Az alábbi példa C# forráskód szabadon felhasználható, egyszerűen implementálhatja a projektjébe, vagy módosíthatja a forráskódot más projektekhez vagy alkalmazásokhoz. Ha szeretné futtatni ezt a példakódot, csak másolja és illessze be a Konzolalkalmazás projektjébe, majd futtassa a projektet.

using System;
using System.Net.Http;
using System.Text;
using System.Web;
namespace HttpApiTester
{
    class Program
    {
        static async System.Threading.Tasks.Task Main(string[] args)
        {
            var username = "john";
            var password = "Xc3ffs";
            var messagetype = "SMS:TEXT";
            var httpUrl = "https://127.0.0.1:9508/";
            var recipient = HttpUtility.UrlEncode("+36201324567", Encoding.UTF8);
            var messagedata = HttpUtility.UrlEncode("TestMessage", Encoding.UTF8);
            
            var sendString = $"{httpUrl}api?action=sendmessage&username=" +
                             $"{username}&password={password}" +
                             $"&recipient={recipient}&messagetype=" +
                             $"{messagetype}&messagedata={messagedata}";

            Console.WriteLine("Sending request: " + sendString);

            var handler = new HttpClientHandler();
            handler.ServerCertificateCustomValidationCallback = 
                (sender, cert, chain, sslPolicyErrors) => { return true; };

            using var client = new HttpClient(handler);

            try
            {
                var response = await client.GetStringAsync(sendString);
                Console.WriteLine("Http response received: ");
                Console.WriteLine(response);

            } catch(Exception e)
            {
                Console.WriteLine(e.Message);
            }
        }
    }
}

1. lépés - Nyissa meg a Visual Studio-t

Az első lépés az SMS küldésére alkalmas alkalmazás létrehozásához a Visual Studio megnyitása. Ha még nem töltötte le a Visual Studio-t, kövesse a fenti Előfeltételek szakaszban található linket a legújabb verzió letöltéséhez. Ha már telepítette a Visual Studio-t a számítógépére, csak annyit kell tennie, hogy rákattint a asztali ikonjára (1. ábra) a Visual Studio megnyitásához.

visual studio megnyitása
1. ábra - Visual Studio 2019 megnyitása

2. lépés - Hozzon létre egy új projektet

Miután megnyitotta a Visual Studio-t, megjelenik a nyitó ablak, ahogyan az a 2. ábrán látható. Itt láthatja a megoldásait, megnyithat egy meglévőt, klónozhat egy tárolót vagy megnyithat egy helyi mappát. Most, hogy kövesse az útmutatót, kattintson a "Create a new project" gombra az SMS küldésére szolgáló projekt létrehozásához.

új projekt létrehozása a visual studioban
2. ábra - Új projekt létrehozása

3. lépés - Válassza ki a Konzolalkalmazást

A következő ablak felsorolja az összes elérhető projekt típust, amelyek létrehozhatók a Visual Studio-ban. Ez a példa egy egyszerű Konzolalkalmazás létrehozását igényli, ahogyan a 3. ábra bemutatja, de az SMS küldés szolgáltatást számos más típusú projektben is használhatja. Tehát itt csak annyit kell tennie, hogy kiválasztja a Konzolalkalmazás opciót az elérhető projekt típusok listájából.

konzolalkalmazás kiválasztása
3. ábra - Konzolalkalmazás kiválasztása

4. lépés - Konfigurálja a projektet

A projekt létrehozása előtt az utolsó lépés a konfigurálása, a projekt egyes részleteinek megadásával. Itt nevet adhat a projektnek, valamint beállíthatja a helyi mappát is, ahogyan a 4. ábrán látható. Ha befejezte a konfigurálást, csak kattintson a "Create" gombra a Konzolalkalmazás projekt létrehozásához.

visual studio projekt beállítása
4. ábra - Visual Studio projekt beállítása

5. lépés - Másolja a példakódot

Miután létrehozta a Konzolalkalmazás projektet, most be kell állítania a példakódot, amelyet végre kell hajtania. Ehhez görgessen fel ezen az oldalon, hogy megtalálja a példakód szakaszt, és jelölje ki a teljes forráskódot, ahogyan az az 5. ábrán látható. Ezután nyomja meg a Ctrl+C billentyűkombinációt a billentyűzetén a forráskód másolásához.

kód másolása a weboldalról
5. ábra - Kód másolása a weboldalról

6. lépés - Illessze be a forráskódot a projektjébe

A Visual Studio-ban a létrehozott projekt tartalmaz egy kezdeti Program.cs forrásfájlt. Ezen a ponton ez az a fájl, amelyet a példaprogram végrehajtásához kell használnia. Itt először jelölje ki a kódot ebben a fájlban, és törölje azt. Ezután, ahogyan a 6. ábra bemutatja, nyomja meg a Ctrl+V billentyűkombinációt a billentyűzetén a példakód beillesztéséhez a Program.cs fájlba. Most a projekt készen áll a használatra.

kód beillesztése a visual studioba
6. ábra - Kód beillesztése a Visual Studio-ba

7. lépés - Hajtsa végre a példaprojektet

Az útmutató utolsó lépése a példaprogram végrehajtása. A Visual Studio-ban egészen egyszerű a projekt futtatása, csak kattintson a Run gombra, ahogyan az a 7. ábrán látható. A program indítása után megjelenik egy konzol ablak, amely kiírja a HTTP kérést, amelyet a program küldött az SMS Gateway-nek. Azt is kiírja, hogy az SMS Gateway válasza szerint sikeres volt-e az SMS kézbesítése.

kód fordítása és futtatása a visual studioban
7. ábra - Kód fordítása és futtatása a Visual Studio-ban

8. lépés - Ellenőrizze a küldés eredményét az Ozeki naplóban

Az Ozeki 10 SMS Gateway-ben könnyen ellenőrizheti, hogy az alkalmazása milyen üzeneteket küldött, mivel a HTTP API szolgáltatás naplózza az összes eseményt, amely akkor történt, amikor engedélyezve volt. Tehát, ha megnyitja az SMS Gateway-t, és kiválasztja a HTTP API szolgáltatás részleteit, láthatja az eseményeket. Ahogyan a 8. ábra mutatja, a szolgáltatás naplózott egy eseményt, amikor a C# példaprogram HTTP kérést küldött a szolgáltatásnak.

http api szolgáltatás naplóinak ellenőrzése
8. ábra - HTTP API szolgáltatás naplóinak ellenőrzése

Az üzenetküldés folyamata szintén visszanézhető az események alapján. Ehhez nyissa meg a HTTP API felhasználói kapcsolatot, amelyet korábban be kellett állítania. A 9. ábra bemutatja, hogyan kezeli a kapcsolat a HTTP kérést, és küldi el az üzenetet a címzettnek, akit a C# programjában megadott.

http api felhasználó naplóinak ellenőrzése
9. ábra - HTTP API felhasználó naplóinak ellenőrzése

Összegzés

Ez az útmutató minden szükséges információt tartalmaz arról, hogyan küldhet SMS-t bármely címzettnek a számítógépéről. Ez a megoldás a C# és az Ozeki SMS Gateway kombinációját használja, amely bármely országban működik, és különféle mobil kapcsolatokon keresztül küldhet és fogadhat SMS-t. Ez sokkal könnyebbé teszi a kommunikációt a munkatársaival és a szervezete ügyfeleivel.

Az Ozeki SMS Gateway egy olyan eszköz, amely HTTP kérések segítségével vezérelhető. Ha többet szeretne megtudni ezekről, látogasson el a SMS fogadása C# HTTP SMS API-val című cikkre, vagy tájékozódjon más támogatott nyelvekről, például a PHP-ról.

Mindössze annyit kell tennie, hogy letölti az Ozeki SMS Gateway-t, és elkezdi építeni a saját megoldását!

More information