C# SMS API teljes forráskóddal

Ha egy hatékony eszközt keresel C#.Net fejlesztők számára, hogy SMS küldési és fogadási képességet adjon C#.Net alkalmazásokhoz, akkor az Ozeki SMS Gateway által nyújtott C# SMS API a legjobb választás. Ez a legjobb C# SMS API 2025-ben. Kiváló, mert nagyon erőforrás-hatékony, és sokkal gyorsabban nyújt információt a beküldött üzeneteidről beküldési és kézbesítési jelentések formájában, mint más SMS API-k. Ez a C# SMS API lehetővé teszi az SMS-ek ütemezését későbbi kézbesítésre, és mind küldésre, mind fogadásra használható mobiltelefonoktól késleltetés nélkül. Olvasd el ezt a cikket, hogy megismerkedj ezzel a lenyűgöző C# SMS megoldással, és megtudd, hogyan használhatod ki előnyeit a saját környezetedben.

Mi az a C# SMS API?

Az Ozeki C# SMS API egy szoftveres felület, amelyet az Ozeki SMS Gateway nyújt, és lehetővé teszi SMS-ek küldését és fogadását C#.Net kódból. Ez a felület használható a C# SMS API klienskönyvtárral több számítógépről egyidejűleg. (1. ábra) A C# SMS API klienskönyvtárat letöltheted erről a weboldalról.

C# SMS API klienskönyvtár letöltése

A C# SMS kliens (forráskód) letölthető az alábbi linkről. A ZIP fájl tartalmaz egy Visual Studio projektet teljes forráskóddal. Szabadon módosíthatod, használhatod és terjesztheted ezt a kódot vagy származékait.

Letöltés: OzekiConsole.zip (51 Kb)
URL: https://ozeki-sms-gateway.com/attachments/5755/OzekiConsole.zip

Hogyan működik a C# SMS API?

Az Ozeki C# SMS API-val hatékonyabban küldhetsz és fogadhatsz SMS üzeneteket, mint hagyományos HTTP vagy REST SMP API megoldásokkal. Ez azért lehetséges, mert az Ozeki C# SMS API létrehoz és fenntart egy állandó TCP/IP kapcsolatot az SMS gateway-hez, és egy erősen optimalizált OZX nevű SMS protokollon keresztül kommunikál. Ez a kommunikációs módszer kevesebb erőforrást igényel CPU, memória és hálózati sávszélesség szempontjából, mint más SMS protokollok. Például egy SMS üzenet beküldése HTTP REST API kérésben legalább 10-szer több adatot igényel, mint egy OZX beküldési kérés.

A legfontosabb előny az állandó TCP/IP kapcsolatból származik. Ennek köszönhetően a C# SMS alkalmazásod azonnal kap beküldési és kézbesítési jelentéseket C# események formájában. A bejövő SMS üzeneteket is késleltetés nélkül kapod meg. Ilyen kapcsolat nélkül vagy lekérdezni kellene az SMS gateway-t a kézbesítési jelentések vagy bejövő SMS-ek letöltéséhez, vagy fel kellene állítani egy TCP/IP figyelőt vagy webszolgáltatást, és tűzfalportot kellene nyitni az üzenetek fogadásához.

Ez a TCP/IP kapcsolat titkosítható SSL/TLS segítségével, és könnyen hozzáadhatsz kliens- és szerver tanúsítvány érvényesítést, hogy ez a C# SMS API kapcsolat rendkívül biztonságos legyen.

A C# SMS API használata:

1. Töltsd le az Ozeki SMS Gateway-t
2. Telepíts egy SMS teszt kapcsolatot
3. Telepíts egy OZX felhasználót
4. Hozz létre egy felhasználónevet és jelszót
5. Engedélyezd a kommunikációs naplózást
6. Nyisd meg a C# SMS projektet a Visual Studio-ban
7. Módosítsd a C# kódot a felhasználónévvel és jelszóval
8. Küldj egy teszt SMS-t C#-ból
9. Ellenőrizd a naplókat az SMS gateway-ben
10. Szimulálj egy bejövő SMS-t a teszt kapcsolattal
11. Végezz élő tesztet az Android telefonoddal

C# SMS API videó bemutató (2 perc)

Hogy gyorsan megértsd, hogyan állíthatod be az SMS gateway-t C# SMS API kapcsolatok fogadására, és hogyan küldhetsz el első SMS-t a C# alkalmazásodból, nézd meg az alábbi videót. Ez a videó mindössze 2 perc 21 másodperc hosszú, és megéri az időt. A videó bemutatja, hogyan hozható létre egy OZX felhasználó az SMS gateway-ben C# SMS API kliensek fogadására, és hogyan indíthatod és futtathatod a letöltött C# SMS API klienskönyvtárat a Visual Studio-ban. A végső rész bemutatja, hogyan küldhetsz egy teszt SMS-t.

Miért jobb az Ozeki C# SMS API?

Az Ozeki C# SMS API remek, mert az SMS küldéséhez szükséges adatmennyiség kisebb, és a Protocol Data Unit (PDU) kódolás és dekódolás jelentősen kevesebb CPU terhelést jelent. Ha használod, a megoldásod kevesebb erőforrást fog használni mindhárom fő területen: memória, CPU és hálózati sávszélesség. Ennek eredményeként az alkalmazásaid gyorsabban fognak működni és válaszkészebbek lesznek.

Hogyan használhatom a C# SMS API-t?

Az Ozeki C# SMS API egy C# osztálykészlet, amely lehetővé teszi SMS üzenetek küldését és fogadását. Használhatod a letöltött projekt megnyitásával a Visual Studio-ban. Miután megnyitottad a projektet, látni fogod, hogy a teljes kód C#.Net nyelven íródott. Az üzenetküldés C# metódushívásokkal történik, a bejövő üzenetek pedig C# események formájában érkeznek. Az SMS API-ra épített SMS alkalmazásod közvetlenül küldhet SMS üzeneteket a mobil hálózatra Android mobiltelefon vagy IP SMS kapcsolattal rendelkező PC használatával. A mobil hálózathoz való kapcsolatot az Ozeki SMS gateway biztosítja, amelyet telepítened kell az Android mobiltelefonodra vagy a Linux számítógépedre. (2. ábra)

Mennyibe kerül a C# SMS API?

Az API egy könyvtár, amely ingyenesen elérhető számodra MIT licenc alatt. Szabadon módosíthatod és terjesztheted, ahogy szeretnéd. Amikor letöltöd az API-t, a csomag tartalmaz egy példa konzolalkalmazást és az Ozeki.Libs.OZX dll teljes forráskódját.

Az egyetlen költség, amit fizetned kell, az az Ozeki SMS Gateway szoftver licencdíja. Egyetlen SMS gateway szolgálhat több száz C# SMS kliensnek a hálózaton. Telepítheted az SMS gateway-t több számítógépre a kapacitás növelése vagy a helyi hálózatok SMS ajánlatainak kihasználása érdekében.

Az SMS költségek tekintetében, ha szöveges üzeneteket küldesz a PC-dhez csatlakoztatott mobiltelefonon keresztül, a költség a telefonodban lévő SIM kártya SMS díjszabásától függ. A legtöbb országban ingyenesen küldhetsz SMS üzeneteket, ha ezt az opciót választod. Van azonban egy korlátozás: egyetlen mobiltelefon nem küldhet több mint 12000 SMS-t naponta. Ezt a kapacitást csak több mobiltelefon csatlakoztatásával növelheted. Amikor SMS-t küldesz a mobiltelefonodon keresztül (2. ábra), telepítened kell az Ozeki Android SMS gateway szoftvert a telefonodra, és Wifi-n keresztül kell csatlakoznod hozzá.

Ha Ozeki SMS Gateway-t telepítesz a Windows vagy Linux számítógépedre, vezeték nélkül küldhetsz SMS-t egy GSM modemmel vagy GSM modem pool-lal, amely a PC-hez csatlakozik. Ezekben az esetekben ugyanazok az ingyenes SMS díjszabások érvényesek, mivel a GSM modemek és GSM modem pool-ok vezeték nélkül működnek SIM kártyákkal.

Ha tartalék vezeték nélküli kapcsolatot beállítani.

Hogyan csatlakozom az SMS gateway-hez?

Amikor a C# SMS alkalmazásodat fejleszted, valószínűleg a laptopodat fogod használni. A Visual Studio a laptopodra lesz telepítve. Ez a laptop csatlakozik az irodai helyi hálózathoz (LAN) Wi-fi vagy Ethernet kapcsolaton keresztül. Az Android mobilod vagy a Windows SMS Gateway rendszered (3. ábra) szintén csatlakozik az irodai LAN-hoz. Amikor az SMS gateway-hez csatlakozol, az SMS Gateway számítógép LAN IP címét fogod használni.

Ahhoz, hogy a C# alkalmazásod csatlakozzon az SMS gateway-hez, tudnod kell az SMS gateway IP címét és portszámát, valamint szükséged lesz egy felhasználónévre és jelszóra. Az SMS gateway IP címe a LAN IP címe lesz. Mivel az SMS gateway szoftver legtöbbször egy másik számítógépen van telepítve, mint a fejlesztő laptopod, ez az IP cím eltér a laptopod IP címétől. A portszám egyszerű. Általában az alapértelmezett portszám, ami 9580. Felhasználónév és jelszó beszerzéséhez létre kell hoznod egy OZX felhasználót (4. ábra). Amikor létrehozod az OZX felhasználót, bármilyen felhasználónevet és jelszót megadhatsz.

Miután megtaláltad az IP címet, a portszámot és létrehoztad a felhasználónevet és jelszót, ezeket az adatokat be kell írnod a C# SMS alkalmazásod kapcsolódási metódusába.

Ha nem szeretnél két számítógépet használni, telepítheted az SMS gateway-t a laptopodra (ugyanarra a számítógépre, ahol a C# alkalmazásodat fejleszted). Ebben az esetben a "127.0.0.1" IP címet és a "9580" portot kell megadnod a kapcsolódási metódusban. (Igen, IPv6 címeket vagy hosztneveket is használhatsz, például 'localhost')

Az saját SMS Gateway használatának előnyei

Ingyenes tesztelés: Nagyon előnyös saját SMS gateway-t üzemeltetni, mert ingyenesen tesztelheted az SMS alkalmazásodat. Szimulálhatsz bejövő SMS üzeneteket, küldhetsz teszt üzeneteket az SMS gateway teszt kapcsolatára, és szimulálhatsz SMS kézbesítési jelentéseket sikeres és sikertelen kézbesítésről. Jó ötlet elolvasni az SMPP szimulátor útmutatót további információkért a tesztelésről.

Korlátlan teljesítménytesztelés: Miután kifejlesztetted az SMS megoldásodat C# nyelven, valószínűleg szeretnél néhány teljesítménytesztet végezni. Az Ozeki SMS gateway-vel nagyon egyszerű nagy mennyiségű SMS üzenettel tesztelni a rendszeredet. A legtöbb esetben csak néhány ezer SMS-t fogsz küldeni, de ha egy ügyfél kéri, akár több millió üzenettel is végezhetsz tesztet. Nézd meg az SMS teljesítményteszt eredményeit, amelyet az Ozeki SMS Gateway-vel végeztünk 1 000 000 SMS-sel.

Könnyű szolgáltatóváltás: Ha a C# kódodat úgy fejleszted, hogy az az Ozeki SMS Gateway-vel működjön, nem kell aggódnod amiatt, hogy egyetlen SMS hálózatra vagy szolgáltatóra vagy kötve. Ugyanazt a C# kódot használhatod, és egyszerűen átváltasz egy másik SMS szolgáltatóra, ha jobb ajánlatot kapsz, az új szolgáltató kapcsolatának beállításával az SMS gateway-ben.

Mi az OZX?

Az OZX a OZeki eXchange rövidítése. Ez egy erősen optimalizált SMS protokoll, amely a C# SMS alkalmazásod és az Ozeki SMS Gateway közötti kommunikációra szolgál. Ez egy TCP/IP-alapú protokoll, amely jelentősen hatékonyabb, mint a hagyományos SMS protokollok, például a SMPP SMS protokoll. A hatékonyság két fő tényezőből származik: nincs szükségtelen adatátvitel (figyeljük meg, hogy mind a http, mind az smpp hatalmas adatfelesleggel rendelkezik), és egy könnyebb, hatékonyabb protokoll feldolgozás lehetséges a protokoll PDU szerkezete miatt.

Mi található a C# SMS API zip-ben?

A zip fájl két projektet tartalmaz (mint az 5. ábrán): egy konzolalkalmazást, amely egy nagyon könnyen érthető kódot mutat be a C# SMS API használatáról, és tartalmazza magának a C# SMS API-nak a forráskódját.

C# SMS API csomag tartalma:

• Példakód (teljes forráskód)
• Ozeki klienskönyvtár (teljes forráskód)

Hogyan nyissam meg a C# SMS API .sln megoldást?

Az Ozeki SMS API megnyitásához meg kell találnod az OzekiConsole.sln fájlt az OzekiConsole.zip csomag kibontása után, és meg kell nyitnod ezt a fájlt a Visual Studio-ban. (6. ábra) Duplán kattinthatsz a megoldásfájlra (.sln), vagy navigálhatsz hozzá a Visual Studio-ban.

Miután megnyitottad a .sln fájlt, két projektet fogsz látni a megoldásban. Az OzekiConsole projekt tartalmazza a példakódot, amely bemutatja, hogyan használhatod a C# SMS API klienskönyvtárat az SMS Gateway-hez való csatlakozáshoz. (7. ábra) A másik projekt az Ozeki.Libs.OZX dll projekt. Ez a projekt tartalmazza a C# SMS API klienskönyvtár teljes forráskódját.

Hogyan jelentkezzek be az SMS gateway-be a C# SMS API-val

A C# SMS API használatához létre kell hoznod egy felhasználónevet és jelszót az SMS gateway-ben. Ha az SMS gateway-t az Android telefonodra telepítetted, be kell jelentkezned a telefonba egy webböngészővel. Ha az SMS gateway-t Windowsra vagy Linuxra telepítetted, egyszerűen csatlakozz hozzá a böngésződdel. Ha még nem telepítetted az SMS gateway-t, most állítsd be az alábbi telepítési útmutatók egyikével: Hogyan állítsam be az SMS Gateway-t Windowsra, Hogyan állítsam be az SMS gateway-t Linuxra. (8. ábra)

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

Ahhoz, hogy SMS-t küldj C#-ból, hozzá kell adnod az ozekisms.dll-t referenciaként a Visual Studio megoldásodhoz. Dönthetsz úgy, hogy hozzáadod a bináris dll-t, vagy hozzáadhatod a forráskódot tartalmazó projektet. Ha a bináris dll-t adod hozzá, a projekt gyorsabban fog fordulni, ha a forráskódot adod hozzá, jobb hibakeresési lehetőségeid lesznek. (9. ábra)

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

1. Töltsd le az Ozeki C# SMS könyvtárat (zip fájl)
2. Csomagold ki a zip fájlt
3. Nyisd meg a Microsoft Visual Studio-t
4. Hozz létre egy új konzolalkalmazást
5. A megoldáskezelőben kattints a "Hozzáadás..." gombra
6. Válaszd ki a "Meglévő projekt" lehetőséget
7. Tallózd meg az OzekiSMSLibrary.csproj fájlt
8. Kattints a Megnyitás gombra
9. Add hozzá az "Ozeki" névteret a konzolalkalmazásodhoz
10. Másold és illeszd be a példát
11. Küldd el az első SMS-t a SendMessage függvénnyel

Hogyan fogadj SMS-t C#-ban

Ahhoz, hogy SMS-t fogadj C#-ban, ugyanúgy kell beállítanod a projektet, mint SMS küldéséhez. Röviden: töltsd le az ozekisms.dll-t bináris vagy forráskód formájában, és add hozzá a projektedhez referenciakönyvtárként. Ezután létrehozhatsz egy példányt a C# osztályból, és feliratkozhatsz az eseményre, amely akkor hívódik, amikor egy SMS érkezik. (10. ábra)

Hogyan fogadj SMS-t C#-ban:

1. Töltsd le az Ozeki C# SMS könyvtárat (zip fájl)
2. Nyisd meg a Microsoft Visual Studio-t
3. Hozz létre egy új konzolalkalmazást vagy nyiss meg egy meglévő projektet
4. Add hozzá a C# SMS könyvtárat a C# megoldásodhoz
5. Add hozzá az "Ozeki" névteret az osztályodhoz
6. Hozz létre egy példányt az üzenet osztályból
7. Iratkozz fel az OnMessageReceived eseményre
8. Írd meg az eseménykezelő kódot
9. Állíts be egy töréspontot az eseménykezelőben
10. Küldj egy teszt üzenetet
11. Várd meg, hogy az SMS elérje a töréspontot

A C# SMS API forráskódjának megértése

//*********************************************************************
// Ozeki C# SMS API - v1.0.0
// Dokumentáció: https://ozeki-sms-gateway.com/p_5755-c-sharp-sms-api.html
//*********************************************************************

using System;
using OZX;

namespace OzekiConsoleClient
{
    class Program
    {
        static OzxClient Client;

        //*************************************************************
        // Főprogram
        //*************************************************************

        static void Main(string[] args)
        {
            createClient();
            printWelcome();

            string command = null;
            string parameters;

            while (command != "exit")
            {
                if (!_promptAvailable) printPrompt();
                readCommand(out command, out parameters);
                _promptAvailable = false;
                dispatchCommand(command, parameters);
            }
        }

        //*************************************************************
        // Következő parancs olvasása