Hogyan töröljünk SMS-t Ruby nyelven

A legegyszerűbb módja az SMS-ek törlésének Ruby nyelven az Ozeki SMS Gateway beépített HTTP/REST SMS API-jának használata. Amikor ezt az API-t használod, SMS-eket küldhetsz HTTP POST kérések 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 továbbítja ezt az SMS-t a címzett telefonjára, és egy HTTP 200 OK választ küld vissza a kérésedre.

hogyan töröljünk sms-t ruby nyelven
1. ábra - Hogyan töröljünk SMS-t Ruby nyelven

Ruby kód SMS-ek törléséhez

Az alábbi Ruby SMS kód minta bemutatja, hogyan küldhetsz ütemezett SMS-t az Ozeki SMS Gateway HTTP REST SMS API-jával a Ruby ozeki_libs_rest gem segítségével. Ez a könyvtár ingyenesen elérhető, és bármilyen projektben felhasználhatod és módosíthatod.

DeleteSms.rb 
require 'ozeki_libs_rest'

configuration = Configuration.new(
    "http_user",
    "qwe123",
    "http://127.0.0.1:9509/api"
);

msg = Message.new
msg.id = "f53efb1a-8ff6-4e62-97c3-2c1e81964b9d"

api = MessageApi.new(configuration)

result = api.delete(Folder.new.inbox, msg)

print(result)
Hogyan használd a Ruby SMS példát:

Ez a Ruby SMS példa bármilyen Ruby alkalmazásban használható. A használathoz le kell töltened az ozeki_libs_rest gem-et. A gem letöltése után hozzá kell adnod egy referenciát a Ruby forráskódodhoz. Ez lehetővé teszi az ozeki_libs_rest gem által nyújtott osztályok használatát. A Message osztállyal létrehozhatod az SMS-t. A MessageApi osztállyal elküldheted az SMS-t az SMS gatewaynek. Az SMS gateway továbbítja az üzenetedet a mobil hálózatnak vezeték nélküli kapcsolaton vagy az interneten keresztül.

DeleteSms.rb letöltése

A cikkben ismertetett forráskód ingyenesen letölthető, használható és módosítható.
Letöltés: DeleteSms.rb.zip (319B)

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

A DeleteSms.rb.zip tartalmazza a DeleteSms.rb fájlt, amely tartalmazza a példakódot, amely bemutatja, hogyan küldj SMS-t. Ez a példakód az alábbiakban látható.

2. ábra - Mi található a DeleteSms.rb.zip fájlban

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

Az SMS törlése Ruby nyelven:

  1. Töltsd le a DeleteSms.rb.zip fájlt
  2. Csomagold ki a .zip fájlt a Letöltések mappából
  3. Nyisd meg a DeleteSms.rb fájlt bármilyen szövegszerkesztőben, például a Windows Jegyzettömbjében
  4. Indítsd el az Ozeki SMS Gateway-t
  5. Hozz létre egy HTTP API felhasználót az Ozeki-ben
  6. Futtasd a DeleteSms.rb Ruby kódot a parancssorból
  7. Ellenőrizd a Küldött mappát az Ozeki SMS Gateway-ben

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

Ahhoz, hogy SMS-t küldhess Ruby 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 Ruby kódodat fejleszted a Visual Studio-ban. A telepítés után a következő lépés az, hogy csatlakoztassad az Ozeki SMS Gateway-t 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, hogy létrehozz egy HTTP SMS API felhasználói fiókot. 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 van állítva, futtathatod a Ruby kódodat.

HTTP API URL az SMS küldéséhez Ruby nyelven

Ahhoz, hogy SMS-t küldhess Ruby nyelven, a Ruby alkalmazásodnak HTTP kérést kell küldenie az SMS gatewaynek. Az API URL az alábbiakban látható. Figyelj arra, 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 Ruby 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 az SMS küldéséhez Ruby nyelven

A Ruby SMS kliens hitelesítéséhez a felhasználónevet és a jelszót base64 kódolású karakterláncként kell elküldened a szervernek egy HTTP kérésben. A használt formátum: base64(felhasználónév+":"+jelszó). Ruby nyelven a következő kóddal végezheted el ezt a kódolást: 

username_password = username + ':' + password
username_password_encoded = Base64.encode64(username_password)
'Basic ' + username_password_encoded

Például, ha a 'http_user' felhasználónevet és a 'qwe123' jelszót kódolod, a következő base64 kódolású karakterláncot kapod: aHR0cF91c2VyOnF3ZTEyMw==.

HTTP kérés fejléc az SMS küldéséhez Ruby nyelven

Az SMS-ek küldéséhez a következő sorokat kell belefoglalnod fejlécként az HTTP kérésbe. Figyelj arra, hogy tartalmazunk egy Content-Type és egy Authorization fejlécet. 

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

HTTP kérés az SMS küldéséhez Ruby nyelven

Egy üzenet törléséhez a Ruby alkalmazásod egy olyan HTTP kérést fog küldeni, mint az alábbi. Figyelj arra, hogy ez a kérés tartalmaz egy HTTP fejléc részt és egy törzs részt. A törzs rész tartalmazza a JSON kódolású SMS azonosítókat. 

POST /api?action=deletemsg HTTP/1.1
Content-Length: 73
Content-Type: application/json
Accept: application/json
Accept-Encoding: gzip;q=1.0,deflate;q=0.6,identity;q=0.3
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Faraday v1.5.0

{	
	"folder":	"inbox",
	"message_ids":	[
		"8ddff323-a0e1-474f-b4b1-58d7fed30009"
	]
}

HTTP válasz, amit a Ruby 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átuszkódot, amely jelzi, hogy az SMS beküldési kérés sikeres volt-e vagy sem. Ezenkívül egy JSON kódolású struktúrát is visszaad, amely hasznos részleteket nyújt az üzenetekről. 

User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 06 Jul 2021 15:58:36 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "8ddff323-a0e1-474f-b4b1-58d7fed30009"
	  ]
	}
}

Ruby SMS példa: DeleteSms.rb

A következő videóban látni fogod, hogyan töltheted le a példafájlt. Ez a 36 másodperces videó nagyon részletes, és minden fontos lépést megmutat, amit meg kell tenned, hogy a projektfájl a számítógépeden legyen. Nem lesz gondod a lépések követésével.

1. videó - Hogyan töltsd le és nyisd meg a fenti fájlt (Videó útmutató)

A példakód

Az alábbi példakód a DeleteSms.rb része. Ez a Ruby kód törli a msg.id változóban tárolt azonosítójú üzenetet (3. ábra). Módosíthatod a változót, hogy a kód egy másik üzenetet töröljön. Ha ismered a Ruby programozási nyelvet, nyugodtan módosíthatod a kódot saját igényeid szerint.

3. ábra - DeleteSms.rb fájl

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

Ebben a videóban megmutatjuk, hogyan futtathatsz egy projektet, amely töröl egy kiválasztott üzenetet. Az Ozeki SMS Gateway elindításával kezdődik, és egy üres bejövő mappával végződik, ahonnan az üzenet törölve lett. Ez az 1:12 hosszú videó mindent elmagyaráz, amit meg kell tenned a projekt elindításához. Az Ozeki SMS Gateway-t használjuk, amely nagyon intuitív felhasználói felületet kínál, így nem lesz gondod a lépések követésével.

2. videó - Hogyan használd a DeleteSms.rb fájlt (Videó útmutató)

Összefoglalás

A fenti cikk bemutatta az SMS törlésének lépéseit Ruby nyelven az Ozeki SMS Gateway segítségével. Fontos a tárolás kiegyensúlyozása és a gyakran tisztított bejövő mappa, ha rendszeresen dolgozol SMS-ekkel. Ez a megoldás nagyszerű példa arra, hogy milyen könnyű kezelni az Ozeki SMS Gateway-t Ruby kódokkal. Azt is meg kell említeni, hogy az Ozeki SMS Gateway lehetővé teszi az SMS-ek adatbázisba történő naplózását, és számos jelentéskészítési lehetőséget kínál az SMS kapcsolatról további információk nyújtásához.

Ne fejezd be itt a tanulmányaidat, látogass el az Ozeki oktatóoldalára, és olvass további dolgokról, mint például az több SMS küldése Ruby nyelven.

Most már csak annyi van hátra, hogy letöltsd az Ozeki SMS Gateway-t, és kezdődhet a munka!

More information