Como Excluir um SMS em F#

A maneira mais simples de enviar SMS a partir de F# é usar a API HTTP/Rest de SMS integrada do Ozeki SMS Gateway. Ao usar essa API, você enviará mensagens SMS enviando uma solicitação HTTP Post para o gateway de SMS. A solicitação HTTP Post conterá uma mensagem formatada em formato json. O gateway de SMS enviará esse SMS para o telefone do destinatário e retornará uma resposta HTTP 200 OK para sua solicitação.

excluindo mensagens sms usando f
Figura 1 - Excluindo mensagens SMS usando F#

Código F# para excluir sms

O exemplo de código F# para SMS abaixo demonstra como você pode excluir SMS usando a API HTTP Rest de SMS do Ozeki SMS Gateway com a biblioteca Ozeki.Libs.Rest em F#. Esta biblioteca é fornecida gratuitamente e você pode usá-la e modificá-la em qualquer um de seus projetos.

Program.fs 
open Ozeki.Libs.Rest

[]
let main argv =
    let configuration = new Configuration (
        Username = "http_user",
        Password = "qwe123",
        ApiUrl = "http://127.0.0.1:9509/api")

    let msg = new Message(
        ID = "ba088274-caac-4e45-bf24-10a446d677e5")

    let api = new MessageApi(configuration)

    let result = api.Delete(Folder.Inbox, msg);

    printfn $"{result}"
    0

Como usar o exemplo de SMS em F#:

Este exemplo de SMS em F# pode ser usado em qualquer aplicativo .NET ou .NET core. Para usá-lo, você deve adicionar a DLL Ozeki.Libs.Rest como uma referência ao seu projeto. Após adicionar a referência do projeto, você deve incluir a diretiva "open Ozeki.Libs.Rest;" na seção de cabeçalho do seu código-fonte F#. Isso permitirá que você use as classes fornecidas pela biblioteca Ozeki.Libs.Rest. Você pode usar a classe MessageApi para excluir o SMS do gateway de SMS.

Baixar DeleteSms.fs

O código-fonte explicado neste artigo pode ser baixado, usado e modificado gratuitamente.
Download: DeleteSms.fs.zip (44.9Kb)

O que está no arquivo DeleteSms.fs.zip?

O arquivo DeleteSms.fs.zip contém a biblioteca Ozeki.Libs.Rest, que fornece todas as ferramentas necessárias para enviar, marcar, excluir e receber mensagens SMS. Você também encontrará o projeto DeleteSms no zip, que contém o código de exemplo para mostrar como excluir um SMS. Este código de exemplo está listado abaixo.

o que está no zip ozeki delete sms
Figura 2 - O que está dentro de DeleteSms.fs.zip

Como excluir SMS de F# (Passos rápidos)

Para excluir SMS de F#:

  1. Instale o Ozeki SMS Gateway
  2. Conecte o Ozeki SMS Gateway à rede móvel
  3. Envie um SMS de teste da interface gráfica do Ozeki
  4. Crie um usuário da API HTTP de SMS
  5. Inicie o Visual Studio
  6. Crie uma solução chamada DeleteSms.sln
  7. Adicione um projeto de console F#: DeleteSms.fsproj
  8. Coloque o código em Program.fs ou DeleteSms.fs
  9. Crie uma solicitação HTTP para excluir o SMS
  10. Leia a resposta HTTP
  11. Escreva a resposta no console
  12. Verifique os logs no gateway de SMS
Instale o Ozeki SMS Gateway e crie um usuário da API HTTP

Para poder excluir SMS de F#, primeiro você precisa instalar o Ozeki SMS Gateway. O gateway de SMS pode ser instalado no mesmo computador onde você desenvolve seu código F# no Visual Studio. Após a instalação, o próximo passo é conectar o Ozeki SMS Gateway à rede móvel. Você pode enviar um SMS de teste da interface gráfica do Ozeki para verificar se sua conexão com a rede móvel está funcionando. O passo final para preparar seu ambiente é criar um usuário da API HTTP de SMS. Crie um usuário com o nome "http_user" e a senha "qwe123" para fazer o exemplo funcionar sem modificações.

Após a configuração do ambiente, você pode executar seu código F#.

URL da API HTTP para receber SMS de F#

Para excluir SMS de F#, seu código F# terá que enviar uma solicitação HTTP para o gateway de SMS. A URL da API é mostrada abaixo. Observe que o endereço IP (127.0.0.1) deve ser substituído pelo endereço IP do seu gateway de SMS. Se o Ozeki SMS Gateway estiver instalado no mesmo computador onde o aplicativo de SMS em F# está sendo executado, pode ser 127.0.0.1. Se estiver instalado em um computador diferente, deve ser o endereço IP desse computador. 

http://127.0.0.1:9509/api?action=rest
Autenticação HTTP para excluir SMS de F#

Para autenticar o cliente de SMS em F#, você precisa enviar o nome de usuário e a senha em uma string codificada em base64 para o servidor em uma solicitação HTTP. O formato usado é: base64(nome de usuário+":"+senha). Em C#, você pode usar o seguinte código para fazer essa codificação: 

var encoding = Encoding.GetEncoding("iso-8859-1");
var usernamePassword = username + ":" + password;
var usernamePasswordEncoded = Convert.ToBase64String(encoding.GetBytes(usernamePassword));

Por exemplo, se você codificar o nome de usuário 'http_user' e a senha 'qwe123', você obterá a seguinte string codificada em base64: aHR0cF91c2VyOnF3ZTEyMw==. Para enviar

Cabeçalho da solicitação HTTP para excluir SMS de F#

Para excluir as mensagens SMS, você precisa incluir as seguintes linhas como cabeçalhos na solicitação HTTP. Observe que incluímos um tipo de conteúdo e um cabeçalho de Autorização. 

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

Requisição HTTP para excluir SMS usando F#

Para solicitar a exclusão do SMS, sua aplicação em F# enviará uma requisição HTTP semelhante à mostrada abaixo. Observe que esta requisição contém uma parte de cabeçalho HTTP e uma parte de corpo HTTP. O corpo HTTP é uma string de dados codificada em JSON. Ela contém o nome da pasta e os IDs das mensagens. 

POST /api?action=deletemsg HTTP/1.1
Connection: Keep-Alive
Content-Length: 73
Content-Type: application/json
Authorization: Basic aHR0cF91c2VyOnF3ZTEyMw==
Host: 127.0.0.1:9509
{
	"folder":	"inbox",
	"message_ids":	[
		"bc7b1368-b496-4350-ba02-7ba36b770618"
		]
}

Resposta HTTP recebida pelo exemplo de SMS em F#

Assim que o gateway SMS receber esta requisição, ele gerará uma resposta HTTP. A resposta HTTP conterá um código de status para indicar se a solicitação de envio de SMS foi bem-sucedida ou não. Ela também retornará uma estrutura codificada em JSON para fornecer detalhes úteis sobre o envio da mensagem. 

HTTP/1.1 200 OK
User-Agent: OZEKI 10.3.116 (www.myozeki.com)
Content-Type: application/json; charset=utf8
Last-Modified: Thu, 10 Jun 2021 11:02:26 GMT
Server: 10/10.3.116
Transfer-Encoding: chunked
{
	"http_code": 200,
    "response_code": "SUCCESS",
    "response_msg": "",
    "data": {
      "folder": "inbox",
      "message_ids": [
        "bc7b1368-b496-4350-ba02-7ba36b770618"
      ]
    }
}

Exemplo de SMS em F#: DeleteSms.sln


Como baixar e usar o projeto DeleteSms (tutorial em vídeo)

Neste vídeo, você aprenderá como baixar o projeto de exemplo DeleteSms em F#. O vídeo começa na página de download e termina com o projeto aberto. Você aprenderá como baixar o projeto e o que fazer com ele para começar a excluir mensagens SMS. O vídeo tem apenas 58 segundos, mas é muito útil. Por ser tão detalhado, você não terá problemas para seguir os passos.

Vídeo 1 - Como baixar e executar o projeto de exemplo acima (Tutorial em vídeo)

O código de exemplo abaixo faz parte da Solução do Visual Studio DeleteSms.sln. Uma solução do Visual Studio pode conter vários projetos e vários arquivos. Nesta solução há apenas dois projetos: DeleteSms.fsproj, Ozeki.Libs.Rest.csproj, e um arquivo: Program.fs.

Figura 3 - DeleteSms.sln

Como usar o projeto para excluir mensagens

Neste vídeo, você aprenderá como usar o projeto para excluir mensagens SMS com a ajuda de F#. O vídeo começará com a abertura do Ozeki SMS Gateway e o levará até a verificação da pasta de entrada vazia. Você também aprenderá como abrir a guia Eventos e ver todos os logs relacionados às mensagens. O vídeo tem apenas 54 segundos e é muito detalhado. Por isso, você não terá problemas para seguir o tutorial.

Vídeo 2 - Como usar a solução DeleteSms.fs (Tutorial em vídeo)

Executando o exemplo de SMS em F# no Windows

Quando você usa o Windows para executar este exemplo de SMS escrito em F#, notará que obtém um desempenho ligeiramente melhor do que quando o executa no Linux. Para entender por que isso acontece, é preciso lembrar que o F# usa o framework .NET para execução de código. Isso ocorre porque a implementação do .NET no Windows é otimizada para desempenho, enquanto o mono, a implementação do .NET no Linux, ainda precisa avançar nesse aspecto.

Resumo

Este guia mostrou como excluir mensagens da sua pasta de entrada com um código em F# e o Ozeki SMS Gateway. Excluir mensagens regularmente é vital se você deseja gerenciar seu armazenamento. Se os passos forem seguidos cuidadosamente, remover SMS da pasta de entrada com um simples código em F# deve ser fácil e rápido. O Ozeki SMS Gateway é confiável e pode ser gerenciado com facilidade, portanto, outras funções também podem ser usadas em passos curtos e simples.

Certifique-se de não encerrar seus estudos aqui, confira a página de tutoriais da Ozeki e leia sobre tópicos como recebimento em F#.

A única coisa a fazer é baixar o Ozeki SMS Gateway e começar a trabalhar agora!

More information