Jak usunąć SMS w Node.js

Najprostszym sposobem wysyłania SMS-ów z Node.js jest użycie wbudowanego interfejsu HTTP/Rest SMS API Ozeki SMS Gateway. Korzystając z tego API, wysyłasz wiadomości SMS, wysyłając żądanie HTTP Post do bramki SMS. Żądanie HTTP Post będzie zawierać wiadomość sformatowaną w formacie JSON. Bramka SMS wyśle tę wiadomość na telefon odbiorcy i zwróci odpowiedź HTTP 200 OK na Twoje żądanie.

jak usunąć wiadomości SMS za pomocą node js
Rysunek 1 - Jak usunąć SMS z Node.js

Kod JavaScript do usuwania wiadomości SMS

Poniższy przykładowy kod JavaScript do obsługi SMS demonstruje, jak możesz usuwać SMS-y za pomocą interfejsu HTTP REST SMS API Ozeki SMS Gateway, korzystając z biblioteki JavaScript Ozeki.Libs.Rest. Ta biblioteka jest dostarczana bezpłatnie i możesz jej używać oraz modyfikować w dowolnym z Twoich projektów.

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);

Jak używać przykładu kodu JavaScript do obsługi SMS:

Możesz użyć klasy Message do tworzenia SMS-ów, a klasy MessageApi do wysyłania SMS-ów do bramki SMS. Bramka SMS przekaże Twoją wiadomość do sieci komórkowej poprzez połączenie bezprzewodowe lub przez Internet.

Pobierz DeleteSms.js

Kod źródłowy omówiony w tym artykule można pobrać, używać i modyfikować bezpłatnie.
Pobierz: DeleteSms.js.zip (3.51Kb)

Co znajduje się w pliku DeleteSms.js.zip?

Plik DeleteSms.js.zip zawiera bibliotekę Ozeki.Libs.Rest, która dostarcza wszystkich narzędzi niezbędnych do wysyłania, oznaczania, usuwania i odbierania wiadomości SMS. Znajdziesz tam również plik DeleteSms.mjs w projekcie, który zawiera przykładowy kod pokazujący, jak usuwać wiadomości SMS. Ten przykładowy kod jest wymieniony poniżej.

przykładowy projekt do usuwania sms za pomocą node js
Rysunek 2 - Katalog DeleteSms.js

Ten projekt ma zależności, więc przed rozpoczęciem należy zainstalować pakiet node-fetch za pomocą następującej komendy: 

npm install node-fetch

Kod 1 - Komenda do instalacji pakietu node-fetch

.

Jak usuwać wiadomości SMS z Node.js (Szybkie kroki)

Aby usuwać wiadomości SMS z Node.js:

  1. Zainstaluj Ozeki SMS Gateway
  2. Podłącz Ozeki SMS Gateway do sieci komórkowej
  3. Wyślij testowego SMS-a z interfejsu Ozeki
  4. Utwórz użytkownika HTTP SMS API
  5. Apache NetBeans
  6. Pobierz przykładowy projekt powyżej
  7. Utwórz SMS, tworząc nowy obiekt Message
  8. Utwórz API do wysłania wiadomości
  9. Użyj metody Delete(), aby usunąć wiadomość(i)
  10. Odczytaj odpowiedź na konsoli i wyświetl wiadomości na konsoli
  11. Sprawdź logi w bramce SMS

Zainstaluj Ozeki SMS Gateway i utwórz użytkownika HTTP API

Aby móc wysyłać SMS-y z Node.js, najpierw musisz zainstalować Ozeki SMS Gateway. Bramka SMS może być zainstalowana na tym samym komputerze, na którym tworzysz swój kod JavaScript w Visual Studio Code lub innym edytorze kodu. Po instalacji następnym krokiem jest podłączenie Ozeki SMS Gateway do sieci komórkowej. Możesz utworzenie użytkownika HTTP SMS API. Utwórz użytkownika z nazwą "http_user" i hasłem "qwe123", aby przykład działał bez modyfikacji.

Po skonfigurowaniu środowiska możesz uruchomić swój kod JavaScript.

URL API HTTP do odbierania SMS-ów z Node.js

Aby odebrać SMS z Node.js, Twój JavaScript będzie musiał wysłać żądanie HTTP do bramki SMS. URL API jest pokazany poniżej. Należy zauważyć, że adres IP (127.0.0.1) powinien zostać zastąpiony adresem IP Twojej bramki SMS. Jeśli Ozeki SMS Gateway jest zainstalowany na tym samym komputerze, na którym działa aplikacja JavaScript do obsługi SMS, może to być 127.0.0.1. Jeśli jest zainstalowany na innym komputerze, powinien to być adres IP tego komputera. 

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

Uwierzytelnianie HTTP do wysyłania SMS-ów z JavaScript

Aby uwierzytelnić klienta SMS w Node.js, musisz wysłać nazwę użytkownika i hasło w zakodowanym ciągu base64 do serwera w żądaniu HTTP. Używany format to: base64(nazwa_użytkownika+":"+hasło). W JavaScript możesz użyć następującego kodu do wykonania tego kodowania: 

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

Na przykład, jeśli zakodujesz nazwę użytkownika 'http_user' i hasło 'qwe123', otrzymasz następujący zakodowany ciąg base64: aHR0cF91c2VyOnF3ZTEyMw==. Aby wysłać

Nagłówek żądania HTTP do wysyłania SMS z JavaScript

Aby wysłać wiadomości SMS, należy dołączyć następujące linie jako nagłówki w żądaniu HTTP. Należy zauważyć, że zawieramy typ zawartości i nagłówek autoryzacji. 

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

Żądanie HTTP do wysyłania SMS z Node.Js

Aby przesłać SMS, Twoja aplikacja Node.Js wyśle żądanie HTTP podobne do poniższego. Należy zauważyć, że to żądanie zawiera część nagłówka HTTP i część ciała HTTP. Ciało HTTP to ciąg danych zakodowany w formacie JSON. Zawiera numer odbiorcy i tekst wiadomości. 

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"
	]
}

Odpowiedź HTTP otrzymana przez przykład SMS w JavaScript

Gdy brama SMS otrzyma to żądanie, wygeneruje odpowiedź HTTP. Odpowiedź HTTP będzie zawierać kod statusu, aby wskazać, czy żądanie wysłania SMS zakończyło się sukcesem czy nie. Zwróci również strukturę zakodowaną w JSON, aby dostarczyć przydatne informacje o przesłaniu wiadomości. 

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"
	  ]
	}
}

Jak usunąć SMS z Node.Js za pomocą API SMS (Samouczek wideo)

Ten film pokazuje, jak pobrać i użyć projektu DeleteSms.js. Po dodaniu potrzebnych plików do projektu możesz zauważyć, że istnieje plik o nazwie Ozeki.Lbis.Rest.js. To plik zawierający MessageApi i wszystko, czego potrzebujesz, aby usunąć SMS za pomocą JavaScript.

Wideo 1 - Jak pobrać Ozeki.Libs.Rest i skonfigurować swój projekt (Samouczek wideo)

Przykład SMS w Node.Js: DeleteSms.mjs (w Notatniku)

Na poniższym rysunku można zobaczyć kod źródłowy projektu Node.js 'DeleteSMS.mjs' (Rysunek 3). Jak widać, użyliśmy Notatnika, aby otworzyć kod. Możesz go również użyć do edycji. Zmień wartość zmiennej msg.ID i usuń dowolną wiadomość.

przykład javascript do usuwania wiadomości sms
Rysunek 3 - DeleteSms.mjs w Notatniku

Przykład SMS w Node.Js: DeleteSms.mjs (w Visual Studio Code)

Jeśli chcesz użyć IDE, które oferuje kolorowanie składni, pomocną dokumentację i rozszerzenia, użyj Visual Studio Code. Jest to lekkie i darmowe środowisko programistyczne, które możesz zacząć używać już teraz. Zmień wartość zmiennej msg.ID i usuń dowolną wiadomość.

przykład javascript do usuwania wiadomości sms
Rysunek 4 - DeleteSms.mjs w Visual Studio Code

Jak sprawdzić, czy SMS został zaakceptowany przez użytkownika HTTP

Po przesłaniu żądania warto sprawdzić w bramie SMS, co zostało odebrane. Możesz sprawdzić log, otwierając szczegóły użytkownika HTTP w konsoli zarządzania Ozeki SMS Gateway. Poniższe wideo pokazuje, na co zwrócić uwagę.

Wideo 2 - Jak usuwać wiadomości SMS za pomocą powyższego kodu JavaScript (Samouczek wideo)

Podsumowując

Ten artykuł pokazuje, jak użyć wspomnianego przykładowego kodu Node.js do usuwania wiadomości SMS za pomocą użytkownika HTTP w Ozeki SMS Gateway. Jeśli codziennie otrzymujesz wiele wiadomości SMS, a wiele z nich jest niechcianych lub zawarte w nich informacje szybko tracą ważność, metoda pokazana tutaj jest dla Ciebie niezbędna. Dokładnie wyczyszczone i dobrze zorganizowane miejsce do przechowywania wiadomości jest bardzo ważne dla efektywnej pracy.

Kontynuuj czytanie tematów takich jak ten na stronie Ozeki, znajdziesz wiele innych artykułów. Sprawdź więcej API SMS w naszym repozytorium GitHub, dowiedz się więcej o użyciu z przewodnika Github: Node.js SMS API.

Zmień na lepsze, pobierz Ozeki SMS Gateway już teraz!

More information