Jak usunąć SMS w Ruby

Najprostszym sposobem usuwania wiadomości SMS z Ruby jest użycie wbudowanego interfejsu HTTP/Rest SMS API Ozeki SMS Gateway. Kiedy używasz tego API, będziesz wysyłać wiadomości SMS poprzez wysłanie żądania 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ąć sms w ruby
Rysunek 1 - Jak usunąć SMS w Ruby

Kod Ruby do usuwania wiadomości SMS

Poniższy przykładowy kod SMS w Ruby demonstruje, jak możesz wysłać zaplanowaną wiadomość SMS używając interfejsu http rest sms api Ozeki SMS Gateway z użyciem gema Ruby ozeki_libs_rest. Ta biblioteka jest dostarczana bezpłatnie i możesz jej używać oraz modyfikować w dowolnym z twoich projektów.

DeleteSms.rb 
require 'ozeki_libs_rest'

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

msg = Message.new
msg.id = "f53efb1a-8ff6-4e62-97c3-2c1e81964b9d"

api = MessageApi.new(configuration)

result = api.delete(Folder.new.inbox, msg)

print(result)
Jak używać przykładu SMS w Ruby:

Ten przykład SMS w Ruby może być używany w dowolnej aplikacji Ruby. Aby go użyć, musisz pobrać gem ozeki_libs_rest. Po pobraniu gema, trzeba dodać do niego referencję w swoim kodzie źródłowym Ruby. To pozwoli ci używać klas dostarczonych przez gem ozeki_libs_rest. Możesz użyć klasy Message do tworzenia SMS. Możesz użyć klasy MessageApi, aby wysłać SMS do bramki SMS. Bramka SMS przekaże twoją wiadomość do sieci komórkowej albo przez połączenie bezprzewodowe, albo przez Internet.

Pobierz DeleteSms.rb

Kod źródłowy wyjaśniony w tym artykule może być pobrany, używany i modyfikowany bezpłatnie.
Pobierz: DeleteSms.rb.zip (319B)

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

DeleteSms.rb.zip zawiera plik DeleteSms.rb, który zawiera przykładowy kod pokazujący, jak wysłać SMS. Ten przykładowy kod jest wymieniony poniżej.

Rysunek 2 - Co znajduje się w DeleteSms.rb.zip

Jak usunąć SMS używając Ruby (Szybkie kroki)

Aby usunąć SMS używając Ruby:

  1. Pobierz plik DeleteSms.rb.zip
  2. Wypakuj plik .zip z folderu Pobrane
  3. Otwórz plik DeleteSms.rb w dowolnym edytorze tekstu, takim jak Windows Notepad
  4. Uruchom Ozeki SMS Gateway
  5. Utwórz użytkownika HTTP API w Ozeki
  6. Uruchom kod Ruby DeleteSms.rb używając wiersza poleceń
  7. Sprawdź skrzynkę Wysłane w Ozeki SMS Gateway

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

Aby móc wysyłać SMS z Ruby, najpierw musisz zainstalować Ozeki SMS Gateway. Bramka SMS może być zainstalowana na tym samym komputerze, na którym tworzysz swój kod Ruby w Visual Studio. Po instalacji, kolejnym krokiem jest podłączenie Ozeki SMS Gateway do sieci komórkowej. Możesz wysłać testową wiadomość SMS z interfejsu Ozeki, aby sprawdzić, czy twoje połączenie z siecią komórkową działa. Ostatnim krokiem przygotowania środowiska jest 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 Ruby.

URL API HTTP do wysyłania SMS z Ruby

Aby wysyłać SMS z Ruby, twoja aplikacja Ruby będzie musiała wysłać żądanie HTTP do bramki SMS. URL API jest pokazany poniżej. Zauważ, ż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 Ruby 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 z Ruby

Aby uwierzytelnić klienta SMS w Ruby, 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 Ruby możesz użyć następującego kodu do wykonania tego kodowania: 

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

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 Ruby

Aby wysyłać wiadomości SMS, musisz dołączyć następujące linie jako nagłówki w żądaniu HTTP. Zauważ, że dołączamy typ zawartości i nagłówek Authorization. 

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

Żądanie HTTP do wysłania SMS-a z Ruby

Aby usunąć wiadomość, Twoja aplikacja Ruby wyśle żądanie HTTP podobne do poniższego. Zauważ, że to żądanie zawiera część nagłówka HTTP i część ciała. Część ciała zawiera identyfikatory SMS-ów zakodowane w formacie JSON. 

POST /api?action=deletemsg HTTP/1.1
Content-Length: 73
Content-Type: application/json
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

{	
	"folder":	"inbox",
	"message_ids":	[
		"8ddff323-a0e1-474f-b4b1-58d7fed30009"
	]
}

Odpowiedź HTTP otrzymana przez przykład SMS w Ruby

Gdy brama SMS odbierze to żądanie, wygeneruje odpowiedź HTTP. Odpowiedź HTTP będzie zawierać kod statusu, wskazujący, czy żądanie wysłania SMS-a zakończyło się sukcesem czy nie. Zwróci również strukturę zakodowaną w JSON, aby dostarczyć Ci przydatnych informacji o wiadomościach. 

User-Agent: OZEKI 10.3.123 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Tue, 06 Jul 2021 15:58:36 GMT
Server: 10/10.3.123
Transfer-Encoding: chunked

{
	"http_code": 200,
	"response_code": "SUCCESS",
	"response_msg": "",
	"data": {
	  "folder": "inbox",
	  "message_ids": [
	    "8ddff323-a0e1-474f-b4b1-58d7fed30009"
	  ]
	}
}

Przykład SMS w Ruby: DeleteSms.rb

W kolejnym filmie zobaczysz, jak pobrać przykładowy plik. Ten 36-sekundowy film jest bardzo szczegółowy i pokaże każdy ważny krok, który musisz wykonać, aby mieć plik projektu na swoim komputerze. Nie będziesz miał problemu z wykonaniem tych kroków.

Wideo 1 - Jak pobrać i otworzyć powyższy plik (Samouczek wideo)

Przykładowy kod

Poniższy przykładowy kod jest częścią pliku DeleteSms.rb. Ten kod Ruby usunie wiadomość z ID przechowywanym w zmiennej msg.id (Rysunek 3). Możesz zmodyfikować zmienną, aby kod usunął inną wiadomość. Jeśli znasz język programowania Ruby, możesz dowolnie modyfikować kod.

Rysunek 3 - Plik DeleteSms.rb

Jak używać przykładowego projektu (Samouczek wideo)

W tym filmie pokażemy Ci, jak uruchomić projekt, który usuwa wybraną wiadomość. Zaczniemy od uruchomienia Ozeki SMS Gateway i zakończymy na pustej skrzynce odbiorczej, z której wiadomość została usunięta. Ten 1:12 minutowy film wyjaśnia wszystko, co musisz zrobić, aby uruchomić projekt. Używamy Ozeki SMS Gateway, które oferuje bardzo intuicyjny interfejs użytkownika, więc nie będziesz miał problemu z wykonaniem kroków.

Wideo 2 - Jak używać pliku DeleteSms.rb (Samouczek wideo)

Podsumowanie

Powyższy artykuł pokazał kroki usuwania SMS-ów w Ruby z pomocą Ozeki SMS Gateway. Utrzymanie zrównoważonego magazynu i często czyszczonej skrzynki odbiorczej jest ważne, jeśli regularnie pracujesz z SMS-ami. To rozwiązanie jest świetnym przykładem, jak łatwo zarządzać Ozeki SMS Gateway za pomocą kodu Ruby. Warto również wspomnieć, że Ozeki SMS Gateway pozwala na logowanie wiadomości SMS do bazy danych i oferuje liczne możliwości raportowania, aby dostarczyć więcej informacji o połączeniu SMS.

Nie kończ swoich studiów tutaj, odwiedź stronę samouczków Ozeki i przeczytaj więcej o takich rzeczach jak wysyłanie wielu SMS-ów w Ruby.

Jedyne, co teraz pozostaje, to pobrać Ozeki SMS Gateway i zacząć pracę!

More information