Hogyan töröljünk SMS-t Node.js-ben

A legegyszerűbb módja SMS küldésének Node.Js-ből 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 gatewaynek az üzenetek elküldéséhez. A HTTP POST kérés egy JSON formátumban formázott üzenetet tartalmaz. Az SMS gateway továbbítja ezt az SMS-t a címzett telefonszámára, és egy HTTP 200 OK választ küld vissza a kérésedre.

hogyan töröljünk sms üzeneteket node js használatával
1. ábra - Hogyan töröljünk SMS-t Node.Js-ből

JavaScript kód SMS üzenetek törléséhez

Az alábbi JavaScript SMS kódminta bemutatja, hogyan törölhetsz SMS-t az Ozeki SMS Gateway http rest sms api-jával a JavaScript Ozeki.Libs.Rest könyvtár segítségével. Ez a könyvtár ingyenesen elérhető, és bármilyen projektben felhasználhatod és módosíthatod.

DeleteSms.mjs 
import { Configuration, Folder, Message, MessageApi } from './Ozeki.Libs.Rest.js';


var configuration = new  Configuration();
configuration.Username = "http_user";
configuration.Password = "qwe123";
configuration.ApiUrl = "http://127.0.0.1:9509/api";

var msg = new Message();
msg.ID = "49c4bec8-348b-42c4-ba56-dee741bc3160";

var api = new MessageApi(configuration);

const result = await api.Delete(Folder.Inbox, msg);

console.log(result);

Hogyan használd a JavaScript SMS példát:

A Message osztály segítségével hozhatod létre az SMS-t, és a MessageApi osztállyal elküldheted az SMS-t az SMS gatewaynek. Az SMS gateway továbbítja az üzenetedet a mobilhálózatnak vezeték nélküli kapcsolaton vagy az interneten keresztül.

DeleteSms.js letöltése

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

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

A DeleteSms.js.zip fájl tartalmazza az Ozeki.Libs.Rest könyvtárat, amely minden szükséges eszközt biztosít SMS üzenetek küldéséhez, jelöléséhez, törléséhez és fogadásához. A projektben találsz egy DeleteSms.mjs fájlt is, amely tartalmazza a példakódot, amely bemutatja, hogyan törölhetsz SMS üzeneteket. Ez a példakód alább látható.

példa projekt sms törléséhez node js használatával
2. ábra - DeleteSms.js könyvtárstruktúra

Ennek a projektnek vannak függőségei, ezért a kezdés előtt telepítened kell a node-fetch csomagot a következő paranccsal: 

npm install node-fetch

1. kód - Parancs a node-fetch csomag telepítéséhez

.

Hogyan töröljünk SMS üzeneteket Node.Js-ből (Gyors lépések)

SMS üzenetek törlése Node.Js-ből:

  1. Telepítsd az Ozeki SMS Gateway-t
  2. Kapcsold az Ozeki SMS Gateway-t a mobilhá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. Apache NetBeans
  6. Töltsd le a fenti példaprojektet
  7. Hozd létre az SMS-t egy új Message objektum létrehozásával
  8. Hozz létre egy API-t az üzeneted elküldéséhez
  9. A Delete() metódus használatával töröld az üzeneted(eke)t
  10. Olvasd el a válaszüzenetet a konzolon, és írd ki az üzeneteket a konzolra
  11. Ellenőrizd a naplókat az SMS gatewayben

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

Ahhoz, hogy SMS-t tudj küldeni Node.Js-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 JavaScript kódodat fejleszted Visual Studio Code-ban vagy bármely más kódszerkesztőben. A telepítés után a következő lépés az, hogy kapcsold az Ozeki SMS Gateway-t a mobilhálózathoz. Küldhetsz egy teszt SMS-t az Ozeki GUI-ból annak ellenőrzésére, hogy a mobilhálózati kapcsolatod működik. A környezet előkészítésének utolsó lépése az, hogy létrehozol egy HTTP SMS API felhasználót. 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 JavaScript kódodat.

HTTP API URL SMS fogadásához Node.Js-ből

Ahhoz, hogy SMS-t fogadj Node.Js-ből, a JavaScript alkalmazásodnak HTTP kérést kell küldenie az SMS gatewaynek. Az API URL alább látható. Figyelj arra, hogy az IP cím (127.0.0.1) helyett az SMS gateway IP címét kell használnod. Ha az Ozeki SMS Gateway ugyanarra a számítógépre van telepítve, ahol a JavaScript SMS alkalmazás fut, ez lehet 127.0.0.1. Ha másik számítógépre van telepítve, annak az IP címét kell használnod. 

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

HTTP hitelesítés SMS küldéséhez JavaScriptből

A Node.Js 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ó). JavaScriptben a következő kóddal végezheted el ezt a kódolást: 

var usernamePassword = username + ":" + password;
return `Basic ${Base64.encode(usernamePassword)}`;

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 SMS küldéséhez JavaScriptből

Az SMS üzenetek 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 SMS küldéséhez Node.Js-ből

Az SMS beküldéséhez a Node.Js alkalmazásod egy olyan HTTP kérést küld, mint az alábbi. Figyelj arra, 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ódolású adatkarakterlánc. Tartalmazza a címzett számát és az üzenet szövegét. 

POST /api?action=deletemsg HTTP/1.1
Connection: close
Content-Length: 73
Content-Type: application/json
Accept: */*
Accept-Encoding: gzip,deflate
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: node-fetch/1.0 (+https://github.com/bitinn/node-fetch)

{
	"folder":	"inbox",
	"message_ids":	[
		"9bd34eb0-244b-4b8e-8115-1f05b3b1ac19"
	]
}

HTTP válasz, amit a JavaScript 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. Egy JSON kódolású struktúrát is visszaad, ami hasznos részleteket nyújt az üzenet beküldéséről. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.120 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Mon, 14 Jun 2021 09:12:00 GMT
Server: 10/10.3.120
Transfer-Encoding: chunked
{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "9bd34eb0-244b-4b8e-8115-1f05b3b1ac19"
	  ]
	}
}

Hogyan töröljünk SMS-t Node.Js-ből az SMS API használatával (Videó útmutató)

Ez a videó bemutatja, hogyan töltsd le és használd a DeleteSms.js projektet. Miután hozzáadtad a szükséges fájlokat a projektedhez, észreveheted, hogy van egy Ozeki.Lbis.Rest.js nevű fájl. Ez a fájl tartalmazza a MessageApi-t és minden szükséges eszközt ahhoz, hogy SMS-t törölj JavaScript segítségével.

1. videó - Hogyan töltsd le az Ozeki.Libs.Rest-et és állítsd be a projekted (Videó útmutató)

Node.Js SMS példa: DeleteSms.mjs (Notepad-ben)

A következő ábrán láthatod a 'DeleteSMS.mjs' Node.js projekt forráskódját (3. ábra). Amint látod, a Notepad-et használtuk a kód megnyitásához. Ezzel szerkesztheted is. Módosítsd a msg.ID változó értékét, és törölj bármilyen üzenetet, amit szeretnél.

javascript példa sms üzenetek törléséhez
3. ábra - DeleteSms.mjs Notepad-ben

Node.Js SMS példa: DeleteSms.mjs (Visual Studio Code-ban)

Ha olyan IDE-t szeretnél használni, amely színkódolást, hasznos dokumentációt és kiegészítőket kínál, használd a Visual Studio Code-ot. Ez egy könnyű és ingyenes programozási környezet, amelyet azonnal elkezdhetsz használni. Módosítsd a msg.ID változó értékét, és törölj bármilyen üzenetet, amit szeretnél.

javascript példa sms üzenetek törléséhez
4. ábra - DeleteSms.mjs Visual Studio Code-ban

Hogyan ellenőrizd, hogy az SMS-t elfogadta-e az HTTP felhasználó

A kérés beküldése után érdemes ellenőrizni az SMS gatewayt, hogy lássad, mit kapott. A naplót az Ozeki SMS Gateway kezelőfelületén az HTTP felhasználó részleteinek megnyitásával ellenőrizheted. A következő videó bemutatja, hogy mire kell figyelni.

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

Összefoglalva

Ez a cikk bemutatja, hogyan használd az említett Node.js példakódot SMS üzenetek törléséhez az Ozeki SMS Gateway HTTP felhasználójával. Ha naponta sok SMS üzenetet kapsz, és közülük számos nemkívánatos, vagy az információ hamar lejár, akkor az itt bemutatott módszer nélkülözhetetlen számodra. Egy alaposan megtisztított és jól szervezett tároló az üzeneteid számára nagyon fontos a hatékony munkához.

Folytasd az ehhez hasonló témák olvasását az Ozeki weboldalán, sok más cikket is találsz. Nézz körül további SMS API-k között a GitHub repository-nkban, tanulj meg többet a használatukról a Github: Node.js SMS API útmutatóból.

Változtass a jobbért, töltsd le most az Ozeki SMS Gateway-t!

More information