Jak naplánovat SMS v Node.js
Nejjednodušší způsob, jak odesílat SMS z Node.Js, je použít vestavěné HTTP/Rest SMS API Ozeki SMS Gateway. Při použití tohoto API budete odesílat SMS zprávy vytvořením HTTP Post požadavku na SMS bránu. HTTP Post požadavek bude obsahovat zprávu ve formátu json. SMS brána následně odešle tuto SMS příjemci a vrátí HTTP 200 OK odpověď na váš požadavek.
JavaScript kód pro odeslání SMS na mobil
Níže uvedený ukázkový kód JavaScriptu pro SMS demonstruje, jak můžete odesílat SMS pomocí HTTP REST SMS API Ozeki SMS Gateway s využitím knihovny Ozeki.Libs.Rest. Tato knihovna je poskytována zdarma a můžete ji používat a upravovat v jakémkoli z vašich projektů.
SendScheduledSms.mjsimport { Configuration, 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.ToAddress = "+36201111111"; msg.Text = "Hello world!"; msg.TimeToSend = new Date(Date.UTC(2021, 5, 21, 14, 55, 0)); var api = new MessageApi(configuration); const result = await api.Send(msg); console.log(result.toString());
Jak použít ukázku JavaScriptu pro SMS:
Můžete použít třídu Message k vytvoření SMS a třídu MessageApi k odeslání SMS na SMS bránu. SMS brána následně přepošle vaši zprávu do mobilní sítě buď prostřednictvím bezdrátového připojení nebo přes internet.
Stáhnout SendScheduledSms.js
Zdrojový kód popsaný v tomto článku lze stáhnout, používat a upravovat zdarma.
Stáhnout: SendScheduledSms.js.zip (4.46Kb)
Co obsahuje soubor SendScheduledSms.js.zip?
Soubor SendScheduledSms.js.zip obsahuje knihovnu Ozeki.Libs.Rest, která vám poskytuje všechny nástroje potřebné pro odesílání a přijímání SMS zpráv. V projektu také najdete soubor SendScheduledSms.mjs, který obsahuje ukázkový kód ukazující, jak odeslat SMS. Tento ukázkový kód je uveden níže.
Tento projekt má závislosti, takže před spuštěním musíte nainstalovat balíček node-fetch pomocí následujícího příkazu:
npm install node-fetch
Jak odeslat naplánovanou SMS z Node.Js (Rychlé kroky)
Pro odeslání naplánované SMS z Node.Js:
- Nainstalujte Ozeki SMS Gateway
- Připojte Ozeki SMS Gateway k mobilní síti
- Odešlete testovací SMS z Ozeki GUI
- Vytvořte HTTP SMS API uživatele
- Apache NetBeans
- Stáhněte si výše uvedený ukázkový projekt
- Vytvořte SMS vytvořením nového objektu Message
- Vytvořte API pro odeslání vaší zprávy
- Použijte metodu Send k odeslání vaší zprávy
- Přečtěte si odpověď na konzoli
- Zkontrolujte logy v SMS bráně
Instalace Ozeki SMS Gateway a vytvoření HTTP API uživatele
Abyste mohli odesílat SMS z Node.Js, musíte nejprve nainstalovat Ozeki SMS Gateway. SMS bránu lze nainstalovat na stejný počítač, kde vyvíjíte svůj JavaScriptový kód v Visual Studio Code nebo jiném editoru kódu. Po instalaci je dalším krokem připojení Ozeki SMS Gateway k mobilní síti. Můžete odeslat testovací SMS z Ozeki GUI a ověřit, že vaše připojení k mobilní síti funguje. Posledním krokem k přípravě prostředí je vytvoření HTTP SMS API uživatele. Vytvořte uživatele s uživatelským jménem "http_user" a heslem "qwe123", aby ukázka fungovala bez úprav.
Po nastavení prostředí můžete spustit svůj JavaScriptový kód.
HTTP API URL pro odesílání SMS z Node.Js
Pro odesílání SMS z Node.Js bude váš JavaScript muset odeslat HTTP požadavek na SMS bránu. API URL je uvedeno níže. Poznámka: IP adresa (127.0.0.1) by měla být nahrazena IP adresou vaší SMS brány. Pokud je Ozeki SMS Gateway nainstalována na stejném počítači, kde běží JavaScriptová SMS aplikace, může to být 127.0.0.1. Pokud je nainstalována na jiném počítači, měla by být použita IP adresa tohoto počítače.
http://127.0.0.1:9509/api?action=rest
HTTP autentizace pro odesílání SMS z JavaScriptu
Pro ověření SMS klienta v Node.Js je třeba odeslat uživatelské jméno a heslo v base64 kódovaném řetězci na server v HTTP požadavku. Použitý formát je: base64(username+":"+password). V JavaScriptu můžete použít následující kód pro toto kódování:
var usernamePassword = username + ":" + password; return `Basic ${Base64.encode(usernamePassword)}`;
Například pokud zakódujete uživatelské jméno 'http_user' a heslo 'qwe123', získáte následující base64 kódovaný řetězec: aHR0cF91c2VyOnF3ZTEyMw==. Pro odeslání
HTTP hlavička požadavku pro odeslání SMS z JavaScriptu
Pro odeslání SMS zpráv je třeba do HTTP požadavku zahrnout následující řádky jako hlavičky. Všimněte si, že zahrnujeme typ obsahu a autorizační hlavičku.
Content-Type: application/json Authorization: Basic QWxhZGRpbjpvcGVuIHNlc2FtZQ==
HTTP požadavek pro odeslání SMS z Node.Js
Pro odeslání SMS váš Node.Js aplikace odešle HTTP požadavek podobný níže uvedenému. Všimněte si, že tento požadavek obsahuje část HTTP hlavičky a část HTTP těla. HTTP tělo je řetězec zakódovaný ve formátu JSON. Obsahuje číslo příjemce a text zprávy.
POST /api?action=sendmsg HTTP/1.1 Connection: close Content-Length: 319 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) { "messages": [ { "message_id": "7f9016d5-1e23-d85d-b425-30a435af529e", "to_address": "+36201111111", "text": "Hello world!", "create_date": "2021-06-14T10:16:21", "vaild_date": "2021-06-21T10:16:21", "time_to_send": "2021-06-14T10:20:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": true } ] }
HTTP odpověď přijatá v JavaScript příkladu pro SMS
Jakmile SMS brána obdrží tento požadavek, vygeneruje HTTP odpověď. HTTP odpověď bude obsahovat stavový kód, který indikuje, zda byl požadavek na odeslání SMS úspěšný nebo ne. Také vrátí strukturu zakódovanou v JSON, která poskytne užitečné detaily o odeslání zprávy.
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": "Messages queued for delivery.", "data": { "total_count": 1, "success_count": 1, "failed_count": 0, "messages": [ { "message_id": "7f9016d5-1e23-d85d-b425-30a435af529e", "from_station": "%", "to_address": "+36201111111", "to_station": "%", "text": "Hello world!", "create_date": "2021-06-14 10:16:21", "valid_until": "2021-06-21 10:16:21", "time_to_send": "2021-06-14 10:20:00", "submit_report_requested": true, "delivery_report_requested": true, "view_report_requested": false, "tags": [ { "name": "Type", "value": "SMS:TEXT" } ], "status": "SUCCESS" } ] } }
Jak odeslat SMS z Node.Js pomocí SMS API (Video návod)
Toto video vám ukáže, jak stáhnout a použít projekt SendScheduledSms.js. Jakmile přidáte potřebné soubory do svého projektu, můžete si všimnout, že existuje soubor s názvem Ozeki.Lbis.Rest.js. Tento soubor obsahuje MessageApi a vše, co potřebujete k odeslání SMS pomocí JavaScriptu.
Příklad SMS v Node.Js: SendScheduledSms.mjs (v Notepadu)
Na obrázku 3 můžete vidět zdrojový kód projektu SendScheduledSMS, otevřený v Notepadu. Můžete jej použít k úpravě kódu, pokud jste obeznámeni s programovacím jazykem Node.js. Změňte hodnoty proměnných pro odeslání vlastní zprávy na vlastní adresu.
Příklad SMS v Node.Js: SendScheduledSms.mjs (v Visual Studio Code)
Pokud chcete používat IDE s barevným zvýrazňováním, rozšířeními a užitečnou dokumentací, použijte Visual Studio Code (Obrázek 4). Je to IDE zdarma, které vám pomůže vytvářet lepší programy. Pokud jste obeznámeni s programovacím jazykem Node.js, klidně upravte hodnoty proměnných pro odeslání vlastní zprávy na vlastní adresu.
Jak ověřit, že SMS byla přijata HTTP uživatelem
Po odeslání SMS je dobré zkontrolovat vaši SMS bránu, abyste viděli, co přijala. Protokol můžete zkontrolovat otevřením detailů HTTP uživatele v konzoli pro správu Ozeki SMS Gateway. Následující video vám ukáže, na co se zaměřit.
Jak ověřit, že SMS byla odeslána do mobilní sítě
Posledním krokem při ověřování postupu je podívat se na protokoly připojení k mobilní síti. Možná budete muset před odesláním zprávy zapnout protokolování v konfiguraci připojení, abyste viděli protokoly. Pokud je protokolování zapnuto, uvidíte telefonní číslo a text odeslané zprávy.
ZávěrHlavní funkcí tohoto článku bylo ukázat vám, jak odesílat naplánované SMS zprávy z Node.js pomocí HTTP uživatele Ozeki SMS Gateway. Pokud jste pozorně následovali kroky, měli byste snadno naplánovat SMS zprávy pomocí vašeho programu v Node.js. Pro efektivní sdílení informací je třeba klást velký důraz na načasování, protože může udržovat provoz zpráv vyvážený a podporuje plynulejší komunikaci.
Pokračujte ve čtení návodů na webové stránce Ozeki pro více informací o tom, jak rozvíjet svůj systém zasílání zpráv. Najděte další návody pro Node.js, jako je Jak přijímat SMS v Node.js, a mnoho dalšího.
Stáhněte si Ozeki SMS Gateway nyní a začněte pracovat!
More information
- Node js odeslat SMS pomocí HTTP REST API (ukázka kódu)
- Node js odeslat více SMS pomocí HTTP REST API (ukázka kódu)
- Node js naplánovat SMS pomocí HTTP REST API (ukázka kódu)
- Node js přijmout SMS pomocí HTTP REST API (ukázka kódu)
- Node js smazat SMS pomocí HTTP REST API (ukázka kódu)
- Github Node js SMS API
- Node js tutoriál Hello world