Kako primiti SMS iz Rubyja

Najjednostavniji način za primanje SMS poruka iz Rubyja je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slat ćete SMS poruke slanjem HTTP Post zahtjeva SMS gatewayu. HTTP Post zahtjev će sadržavati poruku formatiranu u json formatu. SMS gateway će poslati ovaj SMS na telefon primatelja i vratit će HTTP 200 OK odgovor na vaš zahtjev.

Ruby kod za primanje SMS poruka

Ruby SMS primjer koda ispod pokazuje kako možete poslati zakazani SMS koristeći http rest SMS API Ozeki SMS Gatewaya s Ruby ozeki_libs_rest gemom. Ova knjižnica vam je dostupna besplatno i možete je koristiti i mijenjati u bilo kojem od vaših projekata.

ReceiveSms.rb

require 'ozeki_libs_rest'

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

api = MessageApi.new(configuration)

result = api.download_incoming()

print(result, "\n")
result.messages.each do |message|
    print(message, "\n")
end

Kako koristiti Ruby SMS primjer:

Ovaj Ruby SMS primjer može se koristiti u bilo kojoj Ruby aplikaciji. Da biste ga koristili, morate preuzeti ozeki_libs_rest gem. Nakon što je gem preuzet, morate dodati referencu na njega u svom Ruby izvornom kodu. To će vam omogućiti korištenje klasa koje pruža ozeki_libs_rest gem. Možete koristiti klasu Message za kreiranje SMS-a. Možete koristiti klasu MessageApi za slanje SMS-a SMS gatewayu. SMS gateway će proslijediti vašu poruku na mobilnu mrežu bilo putem bežične veze ili putem interneta.

Preuzmite ReceiveSms.rb

Izvorni kod objašnjen u ovom članku može se besplatno preuzeti, koristiti i mijenjati.
Preuzmi: ReceiveSms.rb.zip (319B)

Što je u ReceiveSms.rb.zip datoteci?

ReceiveSms.rb.zip sadrži datoteku ReceiveSms.rb, koja sadrži primjer koda koji vam pokazuje kako poslati SMS. Ovaj primjer koda je naveden ispod.

Slika 2 - Što je unutar ReceiveSms.rb.zip

Kako poslati zakazani SMS iz Rubyja (Brzi koraci)

Da biste poslali zakazani SMS iz Rubyja:

Preuzmite datoteku ReceiveSms.rb.zip
Raspakirajte .zip datoteku iz mape Preuzimanja
Otvorite datoteku ReceiveSms.rb u bilo kojem tekstualnom editoru poput Windows Notepada
Pokrenite Ozeki SMS Gateway
Kreirajte HTTP API korisnika u Ozekiju
Pokrenite ReceiveSms.rb Ruby kod koristeći naredbeni redak
Provjerite poslane poruke u Ozeki SMS Gatewayu

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli slati SMS iz Rubyja, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Ruby kod u Visual studiju. Nakon instalacije, sljedeći korak je povezati Ozeki SMS Gateway s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI-ja kako biste potvrdili da vaša mobilna mrežna veza radi. Konačni korak za pripremu vašeg okruženja je kreiranje HTTP SMS API korisničkog računa. Kreirajte korisnika s korisničkim imenom "http_user" i lozinkom "qwe123" kako bi primjer radio bez izmjena.

Nakon što je okruženje postavljeno, možete pokrenuti svoj Ruby kod.

HTTP API URL za slanje SMS-a iz Rubyja

Da biste poslali SMS iz Rubyja, vaš Ruby će morati poslati HTTP zahtjev SMS gatewayu. API URL je prikazan ispod. Imajte na umu da IP adresa (127.0.0.1) treba biti zamijenjena IP adresom vašeg SMS gatewaya. Ako je Ozeki SMS Gateway instaliran na istom računalu gdje se pokreće Ruby SMS aplikacija, ovo može biti 127.0.0.1. Ako je instaliran na drugom računalu, treba biti IP adresa tog računala.

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

HTTP autentifikacija za slanje SMS-a iz Rubyja

Da biste autentificirali Ruby SMS klijent, morate poslati korisničko ime i lozinku u base64 kodiranom stringu na poslužitelj u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Rubyju možete koristiti sljedeći kod za ovo kodiranje:

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

Na primjer, ako kodirate korisničko ime 'http_user' i lozinku 'qwe123', dobit ćete sljedeći base64 kodirani string: aHR0cF91c2VyOnF3ZTEyMw==. Za slanje

HTTP zaglavlje zahtjeva za slanje SMS-a iz Rubyja

Da biste poslali SMS poruke, morate uključiti sljedeće retke kao zaglavlja u HTTP zahtjevu. Imajte na umu da uključujemo content type i Authorization zaglavlje.

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

HTTP zahtjev za slanje SMS-a iz Rubyja

Da biste zatražili svoje dolazne SMS poruke, vaša Ruby aplikacija će poslati HTTP zahtjev sličan onome ispod. Imajte na umu da ovaj zahtjev sadrži samo dio HTTP zaglavlja.

GET /api?action=receivemsg&folder=inbox HTTP/1.1
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

HTTP odgovor primljen u Ruby SMS primjeru

Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor sadržavat će statusni kod kako bi naznačio je li zahtjev za slanje SMS-a bio uspješan ili ne. Također će vratiti JSON kodiranu strukturu kako bi vam pružio korisne pojedinosti o porukama.

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 06 Jul 2021 14:49:32 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "limit": "1000",
	  "data": [
	    {
	      "message_id": "4524cd1f-f048-4b78-99ec-37bd906e676d",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36203333333",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 3",
	      "create_date": "2021-07-06 14:47:37",
	      "valid_until": "2021-07-13 14:47:37",
	      "time_to_send": "2021-07-06 14:47:37",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "e3125586-3d66-4f91-ac4e-66747653fe24",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36202222222",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 2",
	      "create_date": "2021-07-06 14:47:37",
	      "valid_until": "2021-07-13 14:47:37",
	      "time_to_send": "2021-07-06 14:47:37",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "98895df5-4972-4941-8bf3-5fb0302d1fa8",
	      "from_connection": "http_user@localhost",
	      "from_address": "+36201111111",
	      "from_station": "%",
	      "to_connection": "http_user@localhost",
	      "to_address": "http_user",
	      "to_station": "%",
	      "text": "Hello world 1",
	      "create_date": "2021-07-06 14:47:37",
	      "valid_until": "2021-07-13 14:47:37",
	      "time_to_send": "2021-07-06 14:47:37",
	      "submit_report_requested": true,
	      "delivery_report_requested": false,
	      "view_report_requested": false,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}

Ruby SMS primjer: ReceiveSms.rb

U ovom videu vidjet ćete proces preuzimanja ReceiveSMS.rb s ove stranice s vodičem. Počet će s otvorenom stranicom i završit će s otvorenim projektom. Video je dug samo 30 sekundi, ali sadrži sve informacije koje su vam potrebne za preuzimanje primjera projekta. Lako je razumljiv i detaljan. Nećete imati problema s koracima.

Video 1 - Kako preuzeti i otvoriti datoteku iznad (Video vodič)

Primjer koda

Primjer koda u nastavku dio je ReceiveSms.rb. Ako ste upoznati s programskim jezikom Ruby, slobodno modificirajte primjer projekta prema vlastitim željama i pošaljite svoju prvu testnu poruku.

Kako koristiti primjer projekta

U sljedećem videu vidjet ćete kako možete poslati poruku koristeći primjer projekta. Počet će s otvorenim bilježnicom s izvornim kodom u njemu. Na kraju videa vidjet ćete primljene poruke. Video je dug samo 1 minutu, ali naučit ćete sve korake koje trebate poduzeti kako biste dovršili proces. Video je vrlo detaljan tako da nećete imati problema s praćenjem koraka.

Video 2 - Kako koristiti datoteku ReceiveSms.rb (Video vodič)

Sažetak

Svrha ovog vodiča bila je objasniti korake primanja SMS-a u Rubyju uz pomoć Ozeki SMS Gatewaya. Uz nekoliko jednostavnih koraka, možete proslijediti poruke iz mape primljenih u Ruby program. Ovo rješenje važno je ako želite prikupiti te poruke na odvojenom mjestu. Ozeki SMS Gateway omogućuje vam upravljanje troškovima SMS-a i praćenje SMS prometa.

Svakako nastavite čitati na Ozekijevoj stranici s vodičima gdje možete pronaći više informacija o sličnim temama, poput slanja više SMS-ova u Rubyju.

Jedino što sada preostaje jest preuzeti Ozeki SMS Gateway i neka počne rad!