Integração com o host - Simple HTTP

  1. Entendendo a comunicação
  2. Exemplo de utilização
  3. Configuração do dispositivo
  4. Compilação da aplicação
  5. Configuração do CloudWalk Manager
  6. Testando a comunicação

Entendendo a comunicação

Uma das formas de se estabelecer uma comunicação entre o serviço CloudWalk e um host autorizador é através do protocolo HTTP. O diagrama abaixo representa uma comunicação entre o dispositivo, o serviço CloudWalk e o host autorizador:

CloudWalk

  1. O dispositivo executa o comando network.send;
  2. O switch transacional recebe o conteúdo enviado pelo dispositivo, armazena na variável buf e efetua um post na url configurada para o aplicativo no CloudWalk Manager;
  3. A resposta do post é retornada para o switch transacional;
  4. O dispositivo executa o comando network.receive e recebe a resposta.

Atenção: Após efetuar um network.send e um network.receive, é necessário efetuar um network.hostdisconnect para que seja possível realizar uma nova chamada (send).

Exemplo de utilização

Para fins de teste, disponibilizamos um host autorizador pronto para ser utilizado. O autorizador é extremamente simples, utilizado exclusivamente para fins de testes.

Pré-requisitos

  1. Conta no CloudWalk Manager: Crie uma gratuitamente em https://manager.cloudwalk.io
  2. CloudWalk Framework: Dispositivo devidamente instalado e configurado
  3. Acesso à internet: É necessário que o dispositivo tenha acesso a internet (Ethernet, Dial ou GPRS)

Configuração do dispositivo

Este guia assume que o seu dispositivo já possui o CloudWalk Framework devidamente instalado e configurado, e que o número de série do dispositivo já está cadastrado no CloudWalk Manager.

Caso não tenha certeza dos passos acima, confira a seção CloudWalk Framework - Configuração do dispositivo

Compilação da aplicação

  1. Acesse sua conta no CloudWalk Manager
  2. Selecione a primeira opção: Aplicações
  3. Clique no botão Nova aplicação
  4. Preencha o nome da aplicação, por exemplo: httpapp
  5. Preencha a descrição da aplicação, por exemplo: Teste com HTTP Post
  6. Preencha o autorizador com a URL http://http-echo.cloudwalk.io
  7. Marque Sim na opção 'Aplicação deve ser exibida no menu de serviços?'
  8. Preencha HTTP POST no nome de exibição no POS
  9. Clique no botão Cadastrar aplicação
  10. Deverá ser exibida uma mensagem indicando que a aplicação foi devidamente cadastrada

Configuração do CloudWalk Manager

O último passo consiste em configurar o CloudWalk Manager. Siga o seguinte procedimento:

Cadastre um grupo

  1. Selecione a opção: Grupos
  2. Clique no botão Novo grupo
  3. Preencha o nome do grupo, por exemplo: GRUPO TESTE
  4. Clique no botão Cadastrar grupo
  5. Clique então no botão Atualizar grupo
  6. Selecione a aplicação previamente cadastrada, clicando no checkbox
  7. Clique no botão Atualizar aplicações do grupo

Cadastre o número lógico

Todo dispositivo deve possuir um número lógico, que é a identificação do dispositivo no CloudWalk. Para configurar o número lógico, siga o seguinte procedimento:

  1. Selecione a opção: Números lógicos
  2. Clique no botão Novo número lógico
  3. Informe o número lógico, por exemplo 0001
  4. Marque o grupo criado anteriormente (GRUPO TESTE) e clique no botão Cadastrar número lógico

Associar o número lógico

O próximo passo é associar o dispositivo com o número lógico recém criado, pressionando a tecla F1 (Verifone) ou F (Telium). A seguinte tela será apresentada:

CONFIGURATION MENU

1 CLOUDWALK
2 DEVICE SETTINGS
3 MASTER / VISA
4 ABOUT
5 QUIT

Selecione então a opção 1 LOGICAL NUMBER e informe o número lógico recém cadastrado (0001):

CLOUDWALK SETTINGS

1 LOGICAL NUMBERS
2 DELETE APPS
3 REINSTALL
4 BACK

Após informar o número lógico, pressione a tecla confirmar (verde).

LOGICAL NUMBER

: 0001

translation missing: pt-BR.integration.http.walk_manager_setup.associate_logical_number.paragraph_4

Testando a comunicação

Com o dispositivo preparado, a aplicação compilada e tudo configurado no CloudWalk Manager, chegou a hora de testar a comunicação entre todos os componentes envolvidos: dispositivo, CloudWalk e o host autorizador.

1. Download da aplicação

Pressione a tecla verde e será realizado o download da aplicação previamente configurada no CloudWalk Manager:

  DOWNLOADING ...

Ao finalizar o processo, a seguinte mensagem será exibida:

  DOWNLOAD COMPLETE!


     PRESS GREEN

2. Execução da aplicação

Após baixar a aplicação e pressionar o botão verde, a aplicação será automaticamente executada.

HTTP Post test
Connecting ...

HTTP Post test
Connected!

HTTP Post test
Connected!

Posting ...

HTTP Post test
Connected!

Posting ...

Post response:
CLOUDWALK 0123456789

Se falhar

Verificar configuração de comunicacão do dispositivo, montagem dos cabos e conexão com a internet.

HTTP Post test
Connection failed!

Testando a requisição Post

Existem várias ferramentas e serviços que podem lhe auxiliar a testar o retorno de suas requisições. Um exemplo é o serviço hurl.it, que oferece uma interface bem simples, conforme pode ser observado abaixo:

Hurl.it