Kako primiti SMS iz Go-a

Najjednostavniji način za primanje SMS-a iz Go-a je korištenje ugrađenog HTTP/Rest SMS API-ja Ozeki SMS Gatewaya. Kada koristite ovaj API, slati ćete SMS poruke izdavanjem HTTP Post zahtjeva prema 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.

kako primiti sms iz go-a
Slika 1 - Kako primiti SMS iz Go-a

Go kod za primanje SMS-a na mobitel

Go SMS primjer koda ispod pokazuje kako možete primati SMS koristeći http rest SMS API Ozeki SMS Gatewaya koristeći Go github.com/ozekisms/go_send_sms_http_rest_ozeki paket. Ovaj paket vam je dostupan besplatno i možete ga koristiti i mijenjati u bilo kojem od vaših projekata.

ReceiveSms.go 
package main

import (
	"fmt"

	ozeki "github.com/ozekisms/go_send_sms_http_rest_ozeki"
)

func main() {
	configuration := ozeki.NewConfiguration(
		"http_user",
		"qwe123",
		"http://127.0.0.1:9509/api",
	)

	api := ozeki.NewMessageApi(configuration)

	result := api.DownloadIncoming()

	fmt.Println(result)

	for i := 0; i < len(result.Messages); i++ {
		fmt.Println(result.Messages[i])
	}
}

Kod 1 - ReceiveSms.go

Kako koristiti Go SMS primjer:

Ovaj Go SMS primjer može se koristiti u bilo kojoj Go aplikaciji. Da biste ga koristili, morate preuzeti github.com/ozekisms/go_send_sms_http_rest_ozeki paket. Nakon što je paket preuzet, trebate dodati referencu na njega u svoj Go izvorni kod. To će vam omogućiti korištenje klasa koje pruža github.com/ozekisms/go_send_sms_http_rest_ozeki paket. Možete koristiti klasu Message za kreiranje SMS-a. Možete koristiti klasu MessageApi za slanje SMS-a prema SMS gatewayu. SMS gateway će proslijediti vašu poruku mobilnoj mreži bilo putem bežične veze ili putem interneta.

Preuzmite ReceiveSms.go

Izvorni kod objašnjen u ovom članku može se preuzeti, koristiti i mijenjati besplatno.
Preuzimanje: ReceiveSms.go.zip (1.05Kb)

Što se nalazi u ReceiveSms.go.zip datoteci?

U ReceiveSms.go.zip pronaći ćete datoteku SendSms.go, koja sadrži primjer koda koji vam pokazuje kako poslati SMS. Ovaj primjer koda je naveden ispod.

Slika 2 - Što se nalazi unutar ReceiveSms.go.zip

Kako poslati SMS iz Go-a (Jednostavne smjernice)

Za slanje SMS-a iz Go-a:

  1. Instalirajte HTTP API korisnika
  2. Omogućite bilježenje komunikacijskih događaja na kartici Napredno
  3. Postavite Visual Studio
  4. Preuzmite i raspakirajte datoteku ReceiveSms.go.zip
  5. Pokrenite Ozeki SMS Gateway aplikaciju
  6. Pokrenite ReceiveSms.go Go kod koristeći naredbeni redak
  7. Provjerite zapisnike da vidite je li SMS poslan

Instalirajte Ozeki SMS Gateway i kreirajte HTTP API korisnika

Da biste mogli primati SMS iz Go-a, prvo morate instalirati Ozeki SMS Gateway. SMS gateway se može instalirati na istom računalu gdje razvijate svoj Go kod u bilo kojem uređivaču teksta, kao što je Windows notepad. Nakon instalacije, sljedeći korak je povezivanje Ozeki SMS Gatewaya s mobilnom mrežom. Možete poslati testni SMS iz Ozeki GUI-a 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 Go kod.

HTTP API URL za primanje SMS-a iz Go-a

Za slanje SMS-a iz Go-a, vaš Go će morati izdati HTTP zahtjev prema 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 Go 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 Go-a

Za autentifikaciju Go SMS klijenta, morate poslati korisničko ime i lozinku u base64 kodiranom stringu prema poslužitelju u HTTP zahtjevu. Korišteni format je: base64(korisničko_ime+":"+lozinka). U Go-u možete koristiti sljedeći kod za ovo kodiranje: 

import b64 "encoding/base64"

func (api *MessageApi) createAuthorizationHeader(username string, password string) string {
	var usernamePassword string = username + ":" + password
	var usernamePasswordEncoded string = b64.StdEncoding.EncodeToString([]byte(usernamePassword))
	return "Basic " + usernamePasswordEncoded
}

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 Go-a

Za slanje SMS poruka, 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 Go-a

Za slanje SMS-a, vaša Go aplikacija će poslati HTTP zahtjev sličan onome ispod. Imajte na umu da ovaj zahtjev sadrži samo HTTP zaglavlje koje definira vrstu odgovora koju prihvaćamo, te šaljemo i autorizacijsko zaglavlje. 

GET /api?action=receivemsg&folder=inbox HTTP/1.1
Accept: application/json
Accept-Encoding: gzip
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
User-Agent: Go-http-client/1.1

HTTP odgovor primljen u Go SMS primjeru

Nakon što SMS gateway primi ovaj zahtjev, generirat će HTTP odgovor. HTTP odgovor će sadržavati 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 koja vam pruža korisne detalje o slanju poruke. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Fri, 09 Jul 2021 09:16:35 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": "6f73375b-e085-11eb-8d0e-74d4355e997d",
	      "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-09 09:15:27",
	      "valid_until": "2021-07-16 09:15:27",
	      "time_to_send": "2021-07-09 09:15:27",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "6f6f6764-e085-11eb-8d0e-74d4355e997d",
	      "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-09 09:15:26",
	      "valid_until": "2021-07-16 09:15:27",
	      "time_to_send": "2021-07-09 09:15:27",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    },
	    {
	      "message_id": "6f73375b-e085-11eb-8d0f-74d4355e997d",
	      "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-09 09:15:27",
	      "valid_until": "2021-07-16 09:15:27",
	      "time_to_send": "2021-07-09 09:15:27",
	      "submit_report_requested": true,
	      "delivery_report_requested": true,
	      "view_report_requested": true,
	      "tags": [
	        {
	          "name": "Type",
	          "value": "SMS:TEXT"
	        }
	      ]
	    }
	  ]
	}
}

Kako primiti SMS iz Go-a koristeći Go SMS API (Video tutorial)

Ovaj video vam pokazuje kako preuzeti datoteku ReceiveSms.go.zip s ove stranice. Ako pogledate video, primijetit ćete da su sadržaji ReceiveSms.go.zip datoteke smješteni na Windows radnu površinu. Također ćete vidjeti da pokrećemo naredbeni redak kako bismo poslali SMS.

Go SMS primjer: ReceiveSms.go

Primjer koda ispod dio je datoteke ReceiveSms.go.

Slika 3 - Datoteka ReceiveSms.go

Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika

Nakon što je SMS poslan, dobro je provjeriti vaš SMS gateway kako biste vidjeli što je primio. Dnevnik možete provjeriti otvaranjem detalja HTTP korisnika iz Ozeki SMS Gateway upravljačke konzole. Sljedeći video vam pokazuje što trebate tražiti.

Video 2 - Kako provjeriti je li SMS prihvaćen od strane HTTP korisnika (Video tutorial)

Zaključak

Ovaj članak pokazao je osnovne korake primanja SMS-a u Go-u uz pomoć Ozeki SMS Gatewaya. Ovo rješenje može biti vrlo korisno kada imate određeno mjesto za vaše dolazne poruke, u ovom slučaju, možete ih proslijediti Go programu. Ozeki SMS Gateway nudi izvrsne mogućnosti bilježenja, što znači da možete brzo pronaći greške, što olakšava rad.

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

Jedino što sada preostaje je preuzeti Ozeki SMS Gateway i početi raditi!

More information